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The PRINT Command 


The first time you use the PRINT command after starting the 
MS-DOS operating system, it prompts you for the name of the list 
device. Because the default is "PRN:", (which is the normal 
printer port), you just need to press the "Return" key to 
continue. 

The FORMAT Utility 

If you use the FORMAT utility to format an MS-DOS disk and 
specify a volume identification, you can use the SYS command to 
create a new MS-DOS system volume. 

Directory Paths 

The MS-DOS Version 2.11 operating system supports a feature known 
as "directory paths", which allows you to create and maintain 
private areas or "sub-directories" on the same volume. The 
following are some more "hints" on how to use sub-directories and 
paths: 

1. If you specify a directory path in a command line other than 
COPY, TYPE or DIR, it is ignored, because COMMAND.COM does 
not process directory paths. COPY, DIR and TYPE process 
paths themselves. 

2. If you mistakenly type a "\" in front of an otherwise 
legitimate command (for example, \bin\masm), the MS-DOS 
operating system returns immediately to the prompt without 
any message being displayed. 


Using the EDLIN Editor 

When using the EDLIN editor, use the "Interrupt" key to generate 
an "escape" character when required instead of the Escape key 
(Fll (ESC)). 

Us i ng the CTTY Command 

If you use the "CTTY" command to change the console from device 
"CON:" to device "AUX:", for example, explicit references to 
device "CON:" in subsequent commands continue to be honored. For 
example, the command "COPY C0N:TEXT.TXT" takes input from device 
"CON:" rather than device "AUX:", as expected. 
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Using the RECOVER Utility Program 


The MS-DOS Version 2.11 operating system includes a utility 
program called "RECOVER" for recovering "bad spots" on your 
diskettes. It is described in the Chapter 5 of the Ra i nbow 
MS-DOS Vers i on 2.11 Advanced User * s Guide contained in your 
operating system kit. DIGITAL recommends, however, that you use 
this command only as a "last resort" to recover files from a bad 
diskette. This is because RECOVER could misinterpret data that 
may NOT be corrupted, which could lead to unpredictable results. 

Using the PROMPT Command 

When you use the PROMPT command with the $P option, be sure that 
you specify an existing drive. Using this option with a 
non-existent drive requires that you reset the system. 

Interrupt Vectors 

The MS-DOS Version 2.11 operating system allows you to get or set 
all the MS-DOS interrupt vectors, 20H through 27H, using DOS 
function request 25 H and 35H. 

Serial I/O Functions 


The MS-DOS Version 2.11 operating system implements: 


1 . The ser i al 

I/O 

f unct i on 

14 

"Set/Clear Modem 

S i gna Is." 

2. The serial 

I/O 

f unct i on 

21 

"Program Device 1 

1 nterrupt . 


Using Ports 

The MS-DOS Version 2.11 operating system supports 7M for the 
communications port, printer port, and the extended 
communications port. 

Buffer Overflows 

When you use the communication lOCTL functions and the serial 
receive buffer overflows, the last character is SUB (lAh) . The 
MS-DOS Version 2.11 operating system uses a bit to flag whether 
or not a real SUB character has been received or an actual 
overflow has occurred. The most significant bit of the character 
status byte (CHAR_STAT) is set when the serial receive buffer 
overflows . 
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Device Number 


With the MS-DOS Version 2.11 operating system, the device number 
for the communication lOCTL functions 0, 3# 17» 19* 21, and 23 is 
placed into the communication control blocks or the interrupt 
service routine description. 

lOCTL Communication Driver 

The MS-DOS Version 2.11 operating system contains a new lOCTL 
communication driver, function 26. Function 26 returns a double 
word pointer to a direct high performance entrance into the 
communications drivers. It bypasses the normal front end of 
MS-DOS. This direct entrance avoids the overhead of MS-DOS and 
the lack of MS-DOS re-entry. 

NOTE 

This function is not available in previous 
versions of the MS-DOS operating system. 
Therefore, any application programs using 
function 26 will not work under previous versions 
of digital's MS-DOS operating system. 

Use function 26 only in situations that require faster re-entry 
access to the communications drivers. To use function 26: 


ENTRY 

AX = kk02H 
BX = File handle 
DS:DX = Packet address 

FUNCTION in packet = 26 
(no other entries used) 

Invoke with INT 21H 

EXIT 

FUNCRET = FFH 

BUFFER = Double word pointer to the 

entry of the communications driver 


NOTE 

Call function 26 only once when initializing your 
appl ication. 
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After function 26 gives you the entry address, you use all the 
other lOCTL functions by calling the drivers as follows: 


ES:DI = Packet 
DL = Device number 

1 = Communications port 

2 = Printer port 

2 = Extended communications port 
Invoke the function by performing a: 

CALL DWORD PTR (buffer) 

Where buffer * buffer of the packet returned by 
your previous function 26 call 

All returns in the packet and actions performed are identical to 
those functions invoked through MS-DOS I NT 21H. 
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PREFACE 


INTENDED READERS 


This guide is intended for experienced programmers who wish 
applications and programs for the Rainbow TOO, 100+, 
computers. It provides an overview of the various documents 
the Ra i nbow MS-DOS Vers i on 2.05 Technical Documentation Kit. 


to write 
and 100B 
that form 


Readers who wish to learn how to use Microsoft's Macro Assembler 
should study the Microsoft MS-DOS Operati nq System Macro Assembler 
Manua 1 contained in this kit. 


Guide Organization 

Chapter 1 describes the Rainbow's hardware. 

Chapter 2 discusses the Rainbow's firmware, (the features provided in 
its Read Only Memory (ROM) ) . 

Chapter 3 introduces the MS-DOS operating system: its components, and 

how it stores and retrieves disk files. Chapter 3 also mentions some 
differences between MS-DOS Version 2.05 and Version 2.01. 

Chapter A describes the MS-DOS BIOS, and the additional functions 
provided in the BIOS of MS-DOS Version 2.05* 

Chapter 5 describes some of the differences between the Rainbow 
computer and the IBM PC. Use this chapter if you want to convert 

programs from one system to the other, or if you want to write 
programs that will run on either system. This chapter also includes a 
list of caveats and some useful programming examples. 

Appendix A contains Rainbow specifications for on-disk structures. 

Appendix B contains several Microsoft articles relating to MS-DOS 
funct i ons . 



CHAPTER 1 


RAINBOW HARDWARE 


K1 INTRODUCTION 

This chapter describes the Rainbow computer hardware, emphasizing 
those features of interest to programmers. This chapter assumes that 
you know the operation and characteristics of the Rainbow hardware by 
studying the manuals shipped with every Rainbow computer. 

The Installation Guide provided with each Rainbow computer describes 
the system components. The guide illustrates the system unit, monitor 
unit and keyboard unit. 

This chapter describes the hardware in general. Detailed descriptions 
are given for items relevant to programmers. The definitive hardware 
specification, however, is the system specification for the Rainbow 
computer you are using. 


1.2 GENERAL DESCRIPTION 

Figure 1-1 shows the Rainbow computer. The base system consists of 
three parts: 

• System unit 

• Keyboard 

• Monitor 
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The system unit contains the system module, a large printed circuit 
board where the logic circuits of the system are located. The Rainbow 
100+ computer includes a Winchester hard disk drive. Figures 1-2 and 
1-3 show the system block diagrams for the Rainbow 100 and Rainbow 
100+/100B computers. 
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Figure 1-2: Rainbow 100 System Block Diagram 
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Figure 1-3: Rainbow 100+/100B System Block Diagram 
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1.3 PROCESSORS 

The Rainbow computer uses dual microprocessors, an 8088 and a Z80A. 
These work together to provide the Rainbow computer's functionality. 

System functions are divided between the 8088 and Z80A. The Z80A 
controls the disk drives, while the 8088 controls the video output, 
keyboard, communications input/output (I/O), printer I/O, and all 
optional devices. 

Both microprocessors can access certain shared random access memory 
(RAM), and each can also access private memory. The 8088 clock rate 
is ^ 4.815 Mhz, and the Z 80 A clock rate is A. 012 Mhz. 


l.i+ RANDOM ACCESS MEMORY 

The Rainbow lOOA contains 64K bytes of RAM. When DIGITAL first 
shipped the Rainbow computer you could increase this RAM by inserting 
an optional memory expansion card. This optional RAM card was 
available in two sizes: 64K bytes and 192K bytes for a system total 

of either 128K bytes or 256 K bytes. A 64K byte card is not upgradable 
to a larger size. 

DIGITAL has since announced an adapter card for Rainbow computers that 
permits it to use the expansion RAM option. This makes it possible 
for all Rainbow computers to add a total of 768 K bytes of memory. 

The basic Rainbow lOOB contains 128K bytes of RAM. You can expand the 
memory from 192K bytes to 896 K bytes in multiples of 64K bytes. 

The expansion memory is contained on a printed circuit card that holds 
from one to three "banks" of nine memory chips each. All chip 
positions are socketed so that the chips can be field installed. Each 
bank can be filled with nine memory chips yielding either of two 
capaci ties: 

• 64k bytes 

• 256 K bytes 

As a result, the card can have any of nine possible configurations 
from 64 k bytes to 788 K bytes. Table 1-1 shows various configurations. 
You can purchase the option in 128K byte or 256 K byte configuration. 
You can also purchase expansion kits containing nine 64K-bit or nine 
256K-bit RAM chips (sufficient for one bank). 
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Table 1 - 1 : Rainbow 100 B Optional Memory 


SIZE (K) 


128 (Base Configuration) 

192 

256 (Base Configuration) 

320 

38A 

512 

576 

768 


CHIP SIZES IN 


BANK 1 

BANK 2 

BANK 

64 k 

64 K 


64 K 

64 k 

64 k 

256k 

- 

- 

256K 

64 K 

- 

256K 

64 k 

64 K 

256K 

256K 

- 

256K 

256K 

64 K 

256K 

256K 

256K 


The optional expansion memory contains parity checking circuitry. A 
non-maskable interrupt is generated if a parity error occurs. Its 
handler (which is in the firmware) normally causes the system to 
display an error message, then halt. Should an application program 
perform some other form of error trapping, it must "take over" the 
interrupt and provide its own handler. 

All of the memory except for the ZSOA's 2 K-Private RAM (see next 
paragraph) is of the dynamic type. Such memory must be "refreshed" 
every few milliseconds to insure that its data is not lost. 
Refreshing is done by special circuits that use some of the available 
memory access cycles. The 8088, Z 80 A, direct memory access (DMA) and 
refresh circuitry all access this memory independently of one another. 
When one device attempts to access memory while another is in the 
process of doing so, the attempting device must wait until the memory 
is available. This is known as "contention." Notice that such 
contention usually makes it impossible to program precise timing 
1 oops . 

The Z 80 A can address a total of only 6 AK bytes, and therefore cannot 
access memory locations at addresses greater than OFFFFH. 

Both microprocessors can address the 62K bytes of RAM in their address 
space of OO8OOH through OFFFFH. This shared RAM allows the two 
microprocessors to pass data to one another, a necessary requirement 
of the Rainbow computer's architecture. 

Both the 8088 and Z 80 A have 2 K bytes of private RAM in the address 
space of 00000 to 007FFH. The 8088 private RAM is part of the 6 AK 
dynamic RAM, of which the top 62 K is shared. The Z 80 A private RAM is 
of the static type. As such, it neither needs refreshing nor 
experiences contention for access cycles with the 8088 or other 
devices. This memory should be used for time-critical Z 80 A routines, 
such as programmed diskette reading and writing. 
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The extended communications option contains Direct Memory Access 
capabilities. Such DMA operations can only be performed to and from 
the dynamic RAM in Address space 00000 through OFFFFH. 


1-5 NON-VOLATILE MEMORY (NVM) 

The Rainbow computer has 256 nibbles of non-volatile memory, which 
retains stored values even when you turn the power off. The system 
uses this memory to store its Set-Up values. It is located at address 
EDOOOH through EDOFFH, but should not be directly accessed by 
application programs. 

The Rainbow lOOB firmware provides a slightly different set of NVM 
parameters than the Rainbow 100* s NVM parameters. Also, the Rainbow 
lOOB's Set-Up automatically determines and displays the size of 
installed RAM, whereas the Rainbow lOO's Set-Up simply stores whatever 
value you enter there, whether it accurately reflects the size of 
installed RAM or not. 

Although the NVM is addressed as bytes of data, only the low four bits 
of the data have meaning. This is due to the 256 x h organization of 
the NVM chip. The four most significant bits of each NVM data byte 
are ignored when written, and unpredictable when read. 


1.6 VIDEO DISPLAY MEMORY 

The video logic can use up to 4K bytes of screen RAM and kK bytes of 
attribute RAM. Data to be displayed is placed in this RAM by firmware 
routines. This memory should not be directly accessed by application 
programs. The firmware provides functions for modifying the display 
memory. Portions of the Screen and Attribute RAM are also used for 
firmware variables, flags, pointers, stack, buffer and so forth. 
Accessing these RAM locations can cause a system reset or cause the 
system to stop. 


1 .7 READ ONLY MEMORY 

The Rainbow 100 contains 24K bytes, and the Rainbow lOOB 32K bytes, of 
Read Only Memory (ROM). This ROM contains diagnostic, VT102 terminal 
emulation, and VT102 console routines. These routines are also known 
as the system firmware. 

The diagnostics are described in the manuals you received with your 
computer. The VT102 terminal emulation is described in the Terminal 
Emulation Manual. Read the “Functional Anomalies*' found in the system 
specification if you want to program a remote host to work with the 
Rainbow computer as a terminal. 
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1.8 DISKETTES 

The basic Rainbow computers include a dual-disk drive that can store 
AOOK bytes of data on each of two 5 1/^ inch diskettes. You can add a 
second dual-disk drive, bringing the total on-line diskette storage 
capacity to 1600K bytes, or 1.6 megabytes. A Rainbow computer can 
contain either a Winchester type hard disk or the second RX50 drive, 
not both. (See "Hard Disk Option".) You install the optional disk 
drive in the system module housing. 

A separate card containing a Western Digital 1793 Disk Controller 
chip, and related logic circuits provides control of the diskettes. 
This diskette controller card is part of the basic system. 

You must format diskettes before can write on them. DIGITAL-type 
RX50K diskettes have been preformatted for ten 512-byte sectors per 
track and can be used immediately. Non-DIGITAL diskettes (and those 
that have lost format data) must be formatted for the Rainbow computer 
before you can use them. 

The MS-DOS operating system also requires that diskettes be "soft" 
formatted for its use. This is a different operation than the 
physical formatting required by the hardware. The MS-DOS Version 2.05 
operating system contains a special format utility (FORMAT) that you 
can use to physically and "soft" format your diskettes. 

The 1793 Disk Controller chip has been hard-wired to read and write 
only in double-density mode. The RX50 accesses 80 tracks spaced at 96 
tracks per inch (96 TPI) . The RX 50 can also read A8 TPI diskettes 
with proper software, as can diskettes having different numbers of 
sectors (for example, IBM 8 and 9 sector diskettes). 


1.9 KEYBOARD 

The keyboard communicates with the system module through an 825 IA 
Universal Asynchronous Receiver Transmitter (UART) by means of a 
cable. The cable attaches to the monitor module, using a modular 
telephone connector. The keyboard signals then pass through the 
monitor's cable to the system unit. 

Pressing a key causes a single uniquely coded byte to be serially 
transmitted to the system unit where it generates an interrupt 26H. 
The normal interrupt handler is contained in the firmware. It places 
the incoming keycode into a buffer, from which it can be obtained by 
the application software. This routine is complex and is used by both 
the Terminal mode and Console mode firmware. Applications should NOT 
attempt to do keyboard processing, but should use the functions 
provided in the firmware for accessing keyboard characters. 
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1.10 INTERRUPTS 

Both the 8088 and Z80A mi croprocessors have interrupt capabilities. 
Hardware signals or software instructions can generate 8088 
interrupts. You can program each processor to interrupt the other. 

The Rainbow computer's operating system always treats one of the 
processors as a "master" and the other as a "slave." When the master 
requires the slave to perform a function, it notifies the slave by 
generating an interrupt to it. The original slave then becomes a 
master and the original master becomes a slave. 

The Rainbow lOOB hardware interrupts can be assigned two sets of 
interrupt vectors under software control. The Rainbow lOOB's firmware 
provides routines to move the interrupt vectors from one location to 
another. This is necessary because the Rainbow computer's hardware 
and MS-DOS operating system both use some of the same interrupts. The 
firmware relocation function is intended only for use by the MS-DOS 
operating system. If you try to change vectors from within an 
application you cannot use MS-DOS. If you access the hardware 
directly instead of by the firmware the keyboard-related access 
capabilities are destroyed. 

The system module generates a vertical frequency interrupt either 50 
or 60 times per second, determined by a Set-Up parameter. The 
firmware video display refresh routines use this interrupt. These 
refresh routines include a software interrupt kkH call that the 
operating systems use. They, in turn, generate an interrupt 64H, as a 
source of real-time signals for application use. 

The MS-DOS operating system moves many interrupt vectors to alternate 
locations upon being loaded. Applications must always use the 
switched values. Tables 1-2 and I-3 show the hardware-generated 
interrupts and addresses. 
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Table 1-2: 8o88 Interrupt Types 


Hardware Generated 


Priori ty 

Interrupt Source Type No. (Hex) 

Address (Hex) 



Norm/Relocated 

Norm/Relocated 

Highest 

2 

Parity error 

02 

08 

1 

2 

Vert Freq Interrupt 

20/A0 

80/280 

1 

6 

7201 (Ext Comm Int 1) 

21/A1 

84/284 

1 

2 

Graphics Option 

22/A2 

88/288 

1 

2,6 

DMA (Ext Comm Opt) 

23/A3 

8 C/ 28 C 

i 

3 

7201 (Comm/Printer) 

2it/Ait 

90/290 

1 

2,6 

7201 (Ext Comm Int 0) 

25/A5 

94/294 

1 


(or Winchester controlled) 


1 

2 

825 IA (Keyboard) 

26 /A 6 

98/298 

Lowest 


Z80A 

27/A7 

9C/29C 



Software Generated 



5 

Firmware Functions 

18 

60 


2 

0/S Clock Tic 

2C/AC 

B0/2B0 


it 

MS-DOS 

20 

80 


it 

MS-DOS System Functions 

21 

84 


it 

MS-DOS 

22 

88 


it 

MS-DOS 

23 

8c 


it 

MS-DOS 

24 

90 


it 

MS-DOS 

25 

94 


it 

MS-DOS 

26 

98 


it 

MS-DOS 

27 

9C 



Appl . C 1 ock T i c 

64 

190 


NOTES 

1. Relocated interrupt codes and addresses are only 
applicable to the Rainbow 100+ and lOOB computers. 

2. Initialized by INT 18H Function OCH. 

3. Reset/disabled by INT 18H Function 16H. 

k. MS-DOS reserves all interrupts 20H through 3FH for 
i ts own use . 

5. MS-DOS remaps Int 28H (normal Firmware entry) to 
18H for a applications use during its startup 
operation. 

6. There are signal path names to the Extended 
Communications Option connector. The Extended 
Communications Option only uses 23H and 25H, but 
other devices can use all three types. 
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Table 1-3: Z80A Interrupt Type 

Only 8088 RST 6 30H 


1.11 VIDEO MONITOR 

The video control logic controls the data displayed on the video 
monitor. The DCOll and DC012 DIGITAL chips are used for the control 
logic. The system specification explains the operation of the video 
control logic. 


1.12 I/O CONTROL PORTS 

The 8088 and Z80A processors each send and receive data and control 
information to I/O devices through ports. Special In and Out 
instructions of the microprocessor access these ports (Addresses). 
Figures 1-L and I -5 show the addresses (port numbers) at which the 
several I/O devices are accessed. These figures also show bit use. 
Most of the ports are latches; that is, they hold the data placed in 
them until it is changed. Input and output ports are independent of 
one another. Output ports can only be written into, while input ports 
can only be read. 

NOTE 

Data sent to an output port is generally NOT readable 
by an Input instruction to the same port address. 
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Z80 PORTS 

INPUT (READ) OUTPUT (WRITE) 

HEX PORT 
ADDRESS: ‘ 


CLEAR INT. OF Z80 BY 8088 
(ANY VALUE) 


INTERRUPT 8088 
(ANY VALUE) 


FLOPPY OIAQNOSTIC READ REG. FLOPPY DIAGNOSTIC WRITE REG 
















\ 


STEP 

WG 


DIRC 

RDY 




(20h) 








(1793) 

(1793) 


(RX50) 




21h 






1 



0 » RESET ^ OUT 20 == INVERTED = Z80 RESET 

1 SET > OUT 21 = NORMAL 


GENERAL FLOPPY STATUS REG GENERAL FLOPPY COMMAND REG. 




SIDE 

MOTOR 

MOTOR 



1 

DRIVE 


PRE 

PRE 


MOTOR 

MOTOR 


DRIVE 

DRQ 

IRQ 

SELECT 

ON 

ON 


SELECTED 

40h 

COMP 

COMP 

SIDE 

ON 

ON 

FORCE 

SELECT 



(0) 

C/D 

A/B 


00-11 


1 

0 


C/D 

A/B 

RDY 

00-11 

1 


1793 STATUS REG 


SEE 1793 DATA SHEET 


60h 


1793 COMMAND REG 


SEE 1793 DATA SHEET 


1793 TRACK REG. 1793 TRACK REG 


CURRENT TRACK # 

61h 

(NOT NORMALLY USED, BUT IS 


USED TO FOOL 1793 FOR VT-180 DISKS) 

1793 SECTOR REG 


1793 SECTOR REG. 

LAST SECTOR LOADED, 

62h 

SECTOR FOR NEXT R/W 

TRACK # FROM READ HEADER OP. 


1793 DATA REGISTER 


1793 DATA REG. 

DATA IN 

63h 

DATA OUT, 

TRACK # FOR SEEK 


* EACH PORT ADDRESS SHOWN IS ALSO ACTIVATED BY THREE SHADOW ADDRESSES; E.G. OX, IX, 8X & 9X ALL INTERRUPT THE 8088. 


BU-2239 


gure 1-4: Z80 Ports 
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8088 PORTS 


# 

(HEX) 

7 

6 

INPUT 

5 4 3 2 1 

0 

- BIT - 

7 

6 

OUTPUT 

5 4 3 2 1 

0 

00 



CLEAR 8088 INTERRUPT 
(ANY VALUE) 





INTERRUPT THE Z80 
(ANY VALUE) 



GEN. COMM. STATUS REG 


INT 

Z80 


MHFU 

ENBL 


COMM AND LEO REGISTER 


LED 

LED 

no 

LED 

RTS 

DTR 

SRTS 

SPD 

SEL 


DC-011 WRITE REG. 


04 


COMM BIT RATE REGISTER 


TRANSMIT BIT RATE 

REC BIT RATE 

(SEE TABLE) 

(SEE TABLE) 


MAINTENANCE PORT 


OA 

RECALL 

PROG 

PORT 

LOOP- 

DIAG 

LOOP- 

0 1 0 1 0 

Z80 


NVM 

NVM 

BACK 

BACK 

(STRAPPED TO GND) 
1 1 

RESET 


OC 


6e 


KB DATA REG 


10 













KB STATUS REG 




11 

DSR 

SYN 

BRK 

FE 

OE 

PE 

TX 

EMPTY 

RX 

RDY 

TX 

RDY 

2F 

EXTENDED COMM OPTION: 

OPTION SELECT 1 


40 

41 

DATA IN REG. 





STATUS REG 




42 

43 

n 


□ 







MAINTENANCE PORT 



RECALL 

NVM 

PROG 

NVM 

COMM 

LOOP- 

BACK 

DIAG 

LOOP- 

BACK 

PAR 

TEST 

GRAF. 

VIDEO 

SEC 

DISP. 

BLNK 

Z80 

RESET 



DC-012 WRITE REGISTER 














PRINTER BIT RATE REGISTER 








COMM 

PORT 

CLOCK: 

0=INT 

BIT RATE 
(SEE TABLE) 





1=EXT 




8251 A 



KB DATA REG 














8251A 



KB COMMAND REG 






SEE 

1 

82S1A 

1 

DATA 

SHEET 



7201 








COMM 

PRINTER 

DATA OUT REG 


7201 

COMM 

PRINTER 


COMMAND REGISTER 


50 

• 5F 

EXTENDED GRAPHICS OPTION: 

OPTION SELECT 

60 

■ 6F 

EXTENDED COMM OPTION: 

OPTION SELECT 2 


Figure 1-5: 8o88 Ports 
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1.13 COMMUNICATIONS AND PRINTER INTERFACES 

The basic Rainbow computer communicates to external devices through 
two interfaces - the communications interface and the printer 
interface . These interfaces share a single Intel 827^ (or Nec 7201) 
Universal Synchronous Asynchronous Receiver Transmitter (USART) 
Mul ti -Protocol Serial Controller (MPSC) chip mounted on the system 
motherboard . 


The Intel data sheet and application notes contained in the Ra i nbow 
100+/100B Techni cal Documentation Kit . (order number QV069“GZ) , 
describe the operation of the 827^ chip. Both interfaces use PB25 
25~pin connectors mounted on the rear of the system module. The 
Communication interface connector is a male (DB-25P) . while the 
printer connector is a female (DB-25S) . The communications port 
provides full modem support (in conjunction with I/O port 2) for both 
asynchronous and bisynchronous modes. It has an RS-A23 compatible 
interface conforming to CCITT V.21, V.22, and V.23 specifications. 
This port supports full- and half-duplex modems and break detection. 
The firmware uses the communications port to attach to a host computer 
when in terminal mode. The MS-DOS Version 2.05 operating system 
provides an extensive set of system functions for controlling the 
communications, printer, and optional communications ports. 

The printer port also has an RS-423 interface, which is compatible 
with both DIGITAL and non-DIGITAL printers. Both the firmware and the 
MS-DOS operating system use the printer port to send asynchronous data 
to serial printers such as the DIGITAL LA 50 , LA100, or LQP02 printers. 
Data Terminal Ready (DTR) is supported for this port and can be used 
by software to control printers or other devices that do not support 
the XON/XOFF protocol. The Rainbow lOOB's terminal mode supports both 
XON/XOFF and DTR protocols simultaneously. This means that the device 
attached to the Rainbow lOOB's printer port must assert DTR, or no 
data is sent to the printer, and the system stops. 


In console mode under the MS-DOS operating system, two protocols can 
be selected for the printer port. The Rainbow computer and the MS-DOS 
operating system default to the XON/XOFF protocol. To enable DTR, the 
printer port must be specifically programmed by the application or 
utility. 


Figure 1-6 shows the signal paths to the communications 
ports. Table 1-A shows baud rates available 
communications and printer ports. You initially select 
the Set-Up parameters, but they can also be selected as 
1-A or by using the special serial I/O system functions 
operating system. 


and printer 
for both the 
these ports by 
shown i n Table 
of the MS-DOS 
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PORT COMM PORT 

LOOP BACK CONNECTOR (MALE) 



BU-2241 


Figure 1-6: Communications and Printer Port Signal Paths 
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Table 1-4: Baud Rates Available 


Rate 

Comm 

Nibble 

Value 

Pr i nter 

Bit 0-2 
Value 

50 


0 



75 

>’c 

1 

it 

0 

1 10 


2 



134.5 

it 

3 



150 

it 

4 

it 

1 

200 

it 

5 



300 

it 

6 

it 

2 

600 

it 

7 

it 

3 

1200 

it 

8 

it 

4 

1800 

it 

9 



2000 

it 

A 



2400 

it 

B 

it 

5 

3600 

it 

c 



4800 

it 

D 

it 

6 

9600 

it 

E 

it 

7 

19200 

5v 

F 




To set communication port baud rates, transfer a byte with two nibbles 
from the above table to port 06H. The high nibble sets the receive 
rate, and the low nibble sets the transmit rate. 

To set printer baud rates, transfer a byte with bits 0-2 set to the 
value from the above table to port OEH. Notice that bit 3 of this 
port selects the external clock for the communications port, so use 
care when setting printer baud rates. 


1.14 SYSTEM RESET 

You automatically clear the 8088 when you turn on the computer. You 
can also clear the 8o88 processor at any time by pressing Ctrl/Set-Up 
in Set-Up mode. A special watchdog timer can also reset the system in 
the event it is not refreshed within a period of 100 milliseconds or 
the interrupts are off. The video display routines in the firmware 
refresh the circuit. It is important that application programs 
disable interrupts for no longer than 100 ms. or this circuit can 
reset the system. 

If an application must disable interrupts for a longer period, the 
interrupts off circuitry can be temporarily disabled. Such a 
procedure can adversely affect the video display and any real-time 
dependent system operations. 
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The correct procedure for temporarily disabling the interrupts off 
circuitry is as follows: 

1. Disable interrupts using the CLl instruction 

2. Disable the interrupts off detection circuitry by 
transferring a OOH to 8o88 I/O port lOCH. 

3 . Enable interrupts with the STI instruction when ready. The 
interrupts off detection circuit is automatically enabled. 


1.15 AUTO-START 

When you reset the Rainbow system, the system automatically tests 
several components. When the tests are completed, a main menu is 
displayed that offers a choice of disk drives from which to start the 
operating system. (The Rainbow lOOB contains a new Set-Up feature 
that automatically starts the operating system without requiring you 
to press any keys.) 


1.16 OPTIONAL I/O DEVICES 

Three optional I/O devices are available for the Rainbow series 
computers: 

• A color graphics option 

• An extended communications option 

• A hard disk option 


1 . 16.1 Color Graphics Option 

This option consists of a printed circuit board containing a special 
bit-mapped color video graphics controller chip and related logic that 
you mount on the motherboard. 

The Rainbow computer can operate in text mode or text and graphics 
mode. In text mode (VTIOO text mode), the graph i cs" opt i on video is 
disabled and the standard video control logic (DCOll and DC012) drives 
the monitor. In text and graphics mode, the option's video control 
logic drives the monitor. (You need a color monitor to display color 
graphics). Monochrome graphics can also be obtained using the VR201 . 

The Rai nbow Computer Color/Graphics Programmers Reference Guide i s 
included in the Ra i nbow 100+/100B Techni cal Documentation Kit , (order 
number QVO 69 -GZ) . 
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1.16.2 Extended Communications Option 

An extended communications option provides additional communications 
capabilities. This option consists of a printed circuit card that 
mounts in two 40-pin connectors on the system module. Its 
communication outputs are available on D-submi n i ature connectors at 
the left rear of the system module. 

The option provides the Rainbow computer with a separate high-speed 
communications port that can support clustering and local area 
networking. Asynchronous bit- and byte-synchronous capabilities are 
provided. This option uses a 827^ Mul ti -Protocol Serial Controller 
(MPSC) and a 8273 Direct Memory Access (DMA) controller. 

The 827 ^ MPSC used in the extended communications option is the same 
as the MPSC used by the standard communications/printer ports. The 
BIOS of the MS-DOS Version 2.05 operating system includes a full set 
of routines for controlling the standard communications/printer ports 
and the ports of this option for asynchronous operations. The Ra i nbow 
100 Extended Commun i cat i ons Opt i on Programmer * s Reference Gu i de > 
(order number AA-V1 72A-TV) , describes the option. You cannot use this 
option if you have a hard disk because both options mount (and use) 
the same motherboard connectors. 


1 . 16.3 Hard Disk Option 

Two 5“1/^ inch diameter Winchester hard disks are optionally available 
for the Rainbow 100 and 100B computers. They differ only in the 
amount of storage they provide. The RD 50 hard disk stores up to 5M 
bytes and the RD51 up to lOM bytes of data in fixed-length blocks on 5 
]/k inch (130mm) diameter rigid magnetic disks. They use what is 
called Winchester technology, and are contained in a sealed, 
non-removable enclosure. The Rainbow 100+ computer comes with a lOM 
byte RD 5 I . 

The controller logic is contained in a printed circuit board that 
occupies the extended communications option slot on the system module 
motherboard. It can control one ST506- i nterf ace compatible Winchester 
drive. (The ST506 interface is an industry standard interface.) 


The MS-DOS Version 2.05 operating system contains BIOS drivers for the 
Winchester hard disk option, and the distribution diskette includes a 


backup and restore utility for 
Winchester drive comes with 
partitioning the disk according to 
assigns logical drive names (for 
the drive, and initializes them for 
used . 


use with the Winchester. Each 
utilities for initializing and 
your requirements. Partitioning 
example, E:, F:) to all or part of 
the operating system (s) to be 


1-18 



RAINBOW HARDWARE 


The ROM of the Rainbow 100+ and lOOB computers contains code so you 
can start the system from the Winchester instead of from a diskette. 
An upgrade kit is available that permits a Winchester disk to be field 
installed in the Rainbow computer. You cannot start the operating 
system from the Winchester disk if you upgraded your Rainbow lOOA 
computer to include this hard disk. This is because its ROM does not 
contain the necessary code. The Rainbow can configure the Winchester 
disk for either the CP/M- 86 / 8 O operating system, the MS-DOS operating 
system, or both. 

The MS-DOS Version 2.05 operating system contains drivers for 
programming the hard disk, however, so that files and data can be 
written and read using the hard disk system functions. Sophisticated 
users can us the primitive disk operations contained in the BIOS. 
Chapter 3 discusses these operations. 

You cannot use this option if you have an extended communications 
option because both options mount (and use) the same motherboard 
connectors . 
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2.1 INTRODUCTION 

This chapter describes the basic functionality of the “console'' as 
seen by an application program. It also describes the utility 
functions you can use with application programs. To use this chapter, 
you should be familiar with: 

• The Rainbow system specification for your particular Rainbow 
computer 

• The video controller chips 


2.2 GENERAL 

The programs in ROM (firmware) include: 

1. Diagnostic routines 

2. Terminal and console emulation routines 

3. Set-Up routines, 

A. 8088 and Z80A routines for loading the operating system 

The manuals that come with your Rainbow computer describe diagnostic, 
Set-Up and startup routines. 

fia i nbow 1004-/100B Termi nal Emu 1 at i on Manua 1 (contained in the 
Ra i nbow lOO-r/lOOB Techni cal Documentat i on Kit , (order number 
QVO 69 -GZ) ) , which describes terminal mode. 

The Rainbow 100+ and lOOB computer's firmware includes an auto-start 
capability. This lets you start the operating system from one of the 
possible disk drives without selecting the drive from the main menu. 
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The following list details the functions that are available in the 
Rainbow 100+ and lOOB ROMs which differ in the Rainbow 100 ROMs: 

• The BELL character does not cause a hesitation the first time 
it "beeps," but hesitates only for subsequent BELL characters 
that occur too close together. 

e A new Set-Up parameter permits a choice of either Caps-Lock 
or Shift-Lock mode for the "Lock" key. 

• Every ROM set supports all keyboard variations. At startup, 
the firmware asks you to select a keyboard if the stored 
Set-Up parameters indicate that none had previously been 
selected. The NVM then stores the choice. 

• A new Set-Up parameter allows you to invoke a 
National-Replacement-Character set for country-specific use. 

• The "Compose" algorithm is implemented. Details are provided 
in the manuals that come with your Rainbow computer. 

• The printer port's DTR line is monitored when in terminal 
mode. If it is not asserted, printing does not occur. 

• Pressing Ctrl/2 through Ctrl/8 keys generates the proper 
control codes. 

• Ctr l/<symbol> keys are no longer shift-dependent. 

• The Escape sequences for "Erase- i n- 1 i ne" and "Display" now 
accept selective parameters instead of ignoring all after the 
first parameter. 

• All Set-Up text and all error messages are displayed in 
languages appropriate to the keyboard type you selected and 
the language-cluster supported by the installed ROM set. 

• Single "Shift-2" and "Shift-3" escape sequences apply only to 
the next following graphic character, and are not canceled by 
an intervening escape sequence or other non-graphic 
character . 

• The "Print Screen" key generates an ESC [12 ~ in console 

mode . 

• Ctrl/xx keys auto-repeat. 

• Set-Up automatically determines the amount of installed RAM 
and di splays i t. 
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Details of the implementation of language-clustering, 
nat i onal -repl acement characters, and so forth, are describes in the 
Rai nbow 100+/100B System Specification (contained in the Ra i nbow 
100+/100B Technical Documentation Kit , (order number QV069"GZ.)) 


2.3 UTILITY FUNCTIONS 

The console mode of VT102 emulation acts like a VT102 console 
(although without modem control or local echo). As such, it must 
accept characters for display and control, and it must supply 
characters entered at the keyboard. These, plus several other utility 
functions, are provided for use by programs as follows: 

• Send a character to the "console" for display or control 
(Console-Out) 

• Obtain a character from the keyboard (Level -2 Console- In) 

• Determine if a keyboard key has been depressed (Console-In 
Status) 

• Level 1 (16 bit) Console-In 

• Enable and disable the cursor 

• Initialize interrupt vectors 

• Return the clock rate 

• Set and clear LEDs on the keyboard 

• Send a string of data to the screen 

• Initialize the Comm/Printer 827^ chip to Set-Up parameters 

• Return "Raw" keyboard data 

In addition to the above, the Rainbow 100+ and TT)0B computers have the 
following functions: 

• Return ROM version number 

• Relocate interrupt vectors 

• Ring keyboard bell 

• Get/Set character set usage as per NVM 
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For more information, refer to the system specification for your 
particular Rainbow computer. 

You invoke all functions by setting up the desired function number and 
other parameters in 8088 registers then executing a software interrupt 
18H. Place the desired function code in the Dl register and parameter 
data in other registers according to the needs of the function. The 
application program should save all registers it needs before issuing 
the INT 18H, because the firmware routines save only CS:, SS:, and 
DS:, 


2,1* FUNCTION OOH CONSOLE OUT 

This function sends the character in the AL register to the "console" 
where it is displayed. It accepts and processes ASCII and 8-bit 
multi-national characters as a VT102, that is, escape sequences and 
control characters are executed 

ENTRY 

AL = Character to be displayed 

EXIT 

None 


2.5 CONSOLE IN, CONSOLE IN STATUS, AND LEVEL-1 CONSOLE IN 

Pressing a keyboard key generates an Interrupt 26H in the 8o88 
processor. The keyboard's UART passes a one-byte character code 
identifying the particular key to the firmware's keyboard interrupt 
handler. This code is analyzed to determine whether an action must be 
performed (such as entering Set-Up, Lock mode), or whether the key 
represents a character to be passed to the application. 

If a character is passed to an application, the keycode is stored as 
the low-byte of a two byte entry in a 30 -byte f i r st- i n-f i r st-out raw 
key buffer. The high-byte contains three flags that are set according 
to whether the Shift, Ctrl, and/or Lock keys were depressed or in 
effect. When the character is removed from the raw key buffer, the 
keycode is translated to it ASCII value, or, if a function key, to a 
function key number. If it is a function key, a fourth function key 
flag is also set. Figure 2-1 illustrates this. 
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Bit 


Hi Byte 

765^3210 


Lo Byte 

7 6 5 1 * 3 2 1 0 


<-Not-> 

Used 


I I < Keycode > 

I 1 

I I Function key flag. l=Function key 

I Shift Flag. 1 =Shift key in effect 

Control flag. l=Ctrl key depressed 

Caps Lock Flag. l=Caps lock in effect 


NOTE 

The function-key flag is added only when a Console-In 
function causes the character to be extracted from the 
raw key buffer. 


Figure 2-1: Level-1 Character Format 


Firmware functions can obtain input in either of two levels. Each 
16 -bit character code stored in the raw key buffer remains there 
unt i 1 : 


• A Level-1 Console-In 

• A Level-1 raw key function call is made 

• one of the Level-2 routines requires a character 

The Level-2 Console-ln routine also contains a buffer. Whenever you 
invoke the Level-2 Console-ln function, the next character in its 
buffer, if any, is returned to the application. Usually, no character 
is present in the buffer, so the routine performs the equivalent of a 
Level-1 Console-ln call to obtain a character from the raw key buffer. 

If a character is available in the raw key buffer, it is removed. If 
it is an ASCII character, it is placed into the Level-2 buffer. 

If the character represents a function key code, an escape sequence 
for the key is placed in the Level-2 buffer. That is why the Level-2 
buffer is required. 

DON’T MIX LEVEL-1 AND LEVEL-2 FUNCTIONS. 
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Notice that the Level-2 Console-In Status function also causes a 
character to be removed from the raw key buffer in the event the 
Level -2 buffer is empty and the raw key buffer is not empty. This can 
cause confusion, if you mix Level -1 and Level -2 Console- In and 
Console-In Status calls. If there were a character available in the 
Raw Key buffer when you performed a Level-2 Console Status function, 
you would be informed that a character was available. But if you then 
attempted to obtain that character using the Level -1 Console- In 
function, you would not get it, because it had been removed from the 
raw key buffer by the Level-2 Console Status function and transferred 
into the Level -2 buffer. 

Programs should insure that the Level-2 buffer is empty (by repeatedly 
testing its status and obtaining and discarding any remaining 
characters) before using the Level-1 Console-In function. 

The console emulation code can recognize and respond to escape 
sequences requesting status, cursor position, or other information. 
The responses are ASCII escape sequences which are placed directly 
into the Level -2 buffer. 


2.6 FUNCTION 02H CONSOLE IN (LEVEL-2) 

This function fetches a character from the keyboard buffer. 

ENTRY 

None 

EXIT 

AL = Character from the keyboard buffer (if one was available) 
CL = OOH, No character available 

= FFH, A character was returned in AL 

NOTE 

This function does NOT wait for a key to be depressed, 
if no character is available. 
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2.7 FUNCTION 04H CONSOLE IN STATUS (LEVEL-2) 

This function determine whether a character is available in the 
Level -2 buffer. 

ENTRY 

None 

EXIT 

CL = OOH, No character available 

= FFH, A character is available in the Level-2 buffer 

NOTE 

The character, if any, remains in the Level -2 buffer, 
but the function may cause the raw key buffer to 
become empty. 


2.8 FUNCTION 06H CONSOLE IN (LEVEL-1) 

This function fetches a l6-bit character from the Raw Key buffer. 
ENTRY 


None 

EXIT 

AX = l6-bit character from Raw Key buffer 
CL = OOH, if no character is available 

= OlH, if any characters remain in the Level -2 buffer from a 
previous Level -2 call, whether or not characters are in the 
Raw Key buffer 

= FFH, if a character is available (returned in AX) 

NOTE 

OlH is returned to remove some of the complexity 
surrounding the mixing of Level-1 and Level-2 
functions. 

The two bytes representing the character in the raw key buffer are 
placed in the AX register after being analyzed and translated (see 
F igure 2-1 above) . 
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For non-function keys, the function key flag is 2 ero, and the low-byte 
contains the character code, either ASCII or 8-bit multinational, 
according to the keyboard type being used. The effect of Shift, Ctrl 
and Caps-Lock has already been taken into account for the character. 
For function keys, the Function key flag is a 1, and the low-byte 
contains a number that identifies which function key it is. Your 
Rainbow system specifications list these numbers. 


2.9 FUNCTION 08H DISABLE CURSOR 

2.10 FUNCTION OAH ENABLE CURSOR 

These functions make the cursor visible (Enable), and invisible 
(Disable). They insure that the cursor control logic is not disturbed 
by Function 14H. They must be used in pairs, preceding and following 
the use of function 14H. They are "nested" functions; it takes as 
many enables as disables to redisplay the cursor. If enabled when 
already visible, a "ghost" can appear when the cursor is moved. 


2.11 FUNCTION OCH INITIALIZE INTERRUPT VECTORS 

Function OCH initializes the following interrupt vectors to point to 
their default firmware routines: 


Type Number 
(Hex) 

02 

20 

22 

23 

25 

26 
2C 


Use 

NMI for RAM parity error 
Vertical frequency refresh 
Graphics controller option 
Ext Comm Option DMA controller 
Ext Comm Option 827^ 

Keyboard 8251A 

Time Tic from Vert Refresh 


In addition, the extended communications 
option are reset to their disabled states 
be used by application programs because 
interrupt structure. 


option and the graphics 
This function should not 
it destroys the MS-DOS 


2-8 



F I RMWARE 


2.12 FUNCTION OEM RETURN CLOCK RATE 

This function determines the current Set-Up clock rate. 
ENTRY 


None 

EXIT 

AL = OOH, to indicate 60Hz clock 
= OlH, to indicate 50Hz clock 


2.13 FUNCTION lOH SET KEYBOARD LEDS 

2.14 FUNCTION 12H CLEAR KEYBOARD LEDS 

These functions Set and Clear the keyboard light emitting diodes 
(LEDs). They do not cause any action that can be implied by the label 
of the LED being affected. Firmware normally maintains all but the 
"compose" LED in the proper state. (On Rainbow 100+ and lOOB 
computers, the compose LED is also handled by the firmware.) 

Register AL contains a bit pattern to set (Function lOH) , or clear 
(Function 14H) , the LEDs. A 1 in a bit indicates the LED to be set 
(by function lOH) or cleared (by function 12H) . LEDs whose 
corresponding bits are zero remain unchanged. Figure 2-2 shows the 
keyboard LEDs: 

Bits LED 

76543210 
I III l-Wait 

I I I I Compose 

I I 1 Lock 

I I Hold 

I 

I MUST BE 1 


Figure 2-2; Keyboard LEDs 
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2.15 FUNCTION 11»H SEND DATA TO SCREEN 

This function sends more than one character at a time to the screen. 
Entire strings, up to the length of one line, can be sent, along with 
their attributes, in a single function call. Your Rainbow system 
specification describes the meaning of characters and attributes. 

ENTRY 


AX = OOOOH, Characters and attributes 

« 0001H, Attributes only 

* 0002H, Characters only 

BH = Column number (1 thru 80, or 1 thru 132) 

BL = Line Number (1 thru 2h) 

The maximum column number is a function of the screen width 
( 80 / 132 ) and line width (single/double). Exceeding the line 
length destroys the screen image. 

CX = Number of characters or attributes to transfer 

You are responsible for ensuring that the number of characters 
does not exceed the end-of-line. 

DX = Offset to the start of Attributes relative to the user's DS 
regi ster 

SI = Offset to the start of Characters relative to the user's DS 
register 

BP = Copy of user's DS register 

Both DX and SI must be relative to the same value of DS. 


2.16 FUNCTION 16H INITIALIZE COMMUNICATIONS/PRINTER 827^» TO SET-UP 
PARAMETERS 

This function: 

• Initializes the Communications/Printer 827^ to the Set-Up 
parameters 

• Performs a channel reset for both channels A and B 

• Sets the baud rates 

• Set the number of bits per character 

• Sets receive and transmit clock rates 

• Enables receive and transmit for the Communication and 
Printer ports 
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All this is done according to the Set-Up parameters. 

NOTE 

When data/parity is 7M or 7S, the 827^ is actually set 
for 8N. 


2.17 FUNCTION 18 H RAW KEYBOARD DATA 

This function is provided for diagnostic purposes. 

Figure 2-1 (above) indicates that the Shift, Lock and Ctrl keys can 
only be read in conjunction with another key by looking at the flag 
bits in AH. The Set-Up key is not detectable by a program, but you 
can look at the screen to determine if you are in Set-Up mode. The 
Hold Screen key is not detectable by a program, but the Hold Screen 
LED is lit. 

An application program can determine whether or not the Rainbow is in 
Set-Up mode. 

ENTRY 


None 

EXIT 

AX = Flag bits and keycode, as contained in the Raw Key buffer 
CL = 0, no key available 
= 1 , key ava liable 


NOTE 

The character is removed from the buffer 


NOTE 

The following four functions are not available on the 
Rainbow 100. 
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2.18 FUNCTION lAH RETURN ROM VERSION NUMBER 

This function returns an ASCII text string, identifying the version 
number of the ROMs, to the user's buffer. The format is: 

MM. mm L 

MM identifies the major version, mm the minor revision, both expressed 
in ASCII numerals. In general, minor revisions affect only one ROM, 
while the major version affects both ROMs. L is the language 

variation. mm and L are each followed by a Null (OOH) byte for 
del imi ti ng purposes . 

Programs or operating systems can use this function to determine the 
version and/or language of the ROMs. If you use this function on a 
Rainbow 100 computer, the buffer remains empty, identifying the unit 
as a Rainbow 100 computer. The Rainbow system specification contains 
details of version numbers and language IDs. 

ENTRY 


Dl = lAH 

DX = Offset Address of 8 byte buffer 
BP = Segment address of 8 byte buffer 

EXIT 

None 


2.19 FUNCTION ICH RELOCATE INTERRUPT VECTORS 

The Rainbow 100+ and lOOB computers provide for changing interrupt 
codes 20H through 27H that are associated with the hardware generated 
interrupts to AOH through A7H under software control. When this is 
done it is also usually necessary to move the interrupt vectors 
associated with each interrupt to its new vector address. Function 
lAH provides a convenient way to do this. 

ENTRY 


AH = Interrupt code into whose vector the first source vector is 
relocated. Must be either AOH, OOH (defaults to 20H) , or 
20H. 

AL = Interrupt code whose vector is the first of group to be 
relocated. Must be either OOH (defaults to 20H) , 20H, or 
AOH. 

(If AX = OOH, default vectors are simply initialized) 
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CX = Number of vectors to be relocated. If zero, 16 is relocated 
(the def aul t) . 

Dl = ICH Function Number 

EXIT 

CX = 0, to indicate a successful move 

NOTE 

This function is provided for use by the MS-DOS 
operating system and other operating systems, if 
required. Any use by application programs destroys 
the operating system's interrupt structure. The 
format of the calling process is general, but the only 
source and target addresses supported in the Version 
05 ROM are 20H to/from AOH. 


2.20 FUNCTION lEH RING THE KEYBOARD BELL 

This function rings the keyboard bell. It is a convenience for 
programs that use these firmware functions frequently. 


2.21 FUNCTION 20H GET/SET DIGITAL 8/7 BIT CHARACTER CODE USAGE IN NVM 

This function provides a method of reading or changing the NVM bit(s) 
that control character code usage. These can also be set or reset in 
Set-Up . 

ENTRY 


AH = 0, for SET 
= 1, for GET 

AL = 0, for DIGITAL-8 bit character set 

= 1, for 7“bit national replacement character codes 

EXIT (GET) 

AL = 0, for DIGITAL-8 

= 1, for 7”bit national replacement character codes 
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2.22 STACK CONSIDERATIONS 

Both hardware and software interrupts place three words of addresses 
and flags onto whatever stack is currently being used, either the 
operating system's, your program's, or the firmware's. 

In addition, the firmware's hardware interrupt handlers push their 
registers onto the current stack, and can be interrupted in turn by 
other hardware devices whose handlers push even more on the current 
stack. Therefore all application programs should provide a stack with 
at least 62 bytes more than are required by the application itself, 
which is the worst case possible. 

Another stack-related precaution is that application handlers for 
hardware interrupts should NOT use either registers or the stack for 
passing parameters, because these might get changed by an intervening 
interrupt process. Nor should they use a private stack of their own. 
The firmware interrupt handlers test to determine whether their own 
stack is in place. If not, one is set up. This can cause problems. 
Consider the following situation. A user's hardware interrupt handler 
is in place for, say, the Communications port, and the handler sets up 
its own stack. If a character were to be received during execution of 
the latter part of the video refresh routine, (when interrupts are 
enabled), and the user's interrupt handler had set up its stack, then 
a keyboard interrupt was generated. The Firmware's keyboard routine 
would find a non-firmware stack in place, so would again set up the 
firmware's stack. In doing so it destroys the original video refresh 
routine's pushed environment, crashing the system. Software generated 
interrupt handlers do not have this problefh since they can never 
interrupt a hardware handler. 


2.23 SYSTEM PARAMETER DATA 

The firmware maintains one l6-bit word of flags in Attribute RAM at 
location EFFFEH, which describes the system state. These flags are 
used primarily by the firmware, but can be used by application 
programs for special purposes. When this word is loaded into a 
register, its bits have the following meaning: 
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Table 2-1: System Parameter Data Flags 


Bit 

Flag 

Meaning 

0 

when: 

1 

0 

Emulator : 

Console Mode 

Terminal Mode 

1 

On/Off Line: 

On-Line 

Of f-L i ne 

2 

Set-Up mode: 

Normal 

Set-Up mode 

3 

Hold Screen 

Normal 

Hold Scrn in effect 


Scroll I/P: 

Normal 

Sm Scroll in process 

5 

Reserved 



6 

Reserved 



* 1 

Print Screen Key: 

Not Pressed 

Pressed 

8 

Comm Opt Present: 

Present 

Not present 

9 

RX50 Ctrl Bd.: 

Present 

Not present 

10 

Graphics Bd.: 

Present 

Not present 

*5V] 1 

Memory Option: 

Present 

Not Present 

12 

Reserved 



13 

Reserved 



11* 

Reserved 



15 

Reserved 




* The Print Screen Key flag bit is only in the Rainbow 100+ and 

lOOB computers. The firmware sets this bit whenever you press 

the Print Screen Key, but does not reset it. If an application 

tests this bit more than once, it must reset the flag bit after 

each test. 

The memory option bit is only meaningful for Rainbow 100 
computers equipped with a Rainbow 100 expansion RAM board. 


2.24 LEVEL-1 CONSOLE-IN FUNCTION KEY CODES 

The Level-1 (l6-bit) Console-In function of the Rainbow computer's 
firmware returns a one in bit 0 of the most significant byte of the 
l6-bit value if the depressed key is a function key. In this case, 
the least significant byte is not the ASCII value of the character, 
but is an arbitrary code used to identify which key was depressed. 
The codes generated are shown in Table 2-2. 
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Table 2-2 : Level -1 Console- I n Funct i on Key Codes 


Key Level -1 

Key 
Code 
(Hex) 

Level -2 
Esc Seq 

Key Level -1 

Key 
Code 
(Hex) 

Level -2 
Esc Seq 

Help 

0 

Esc 

C 2 

8 ~ 

Down-Arrow 

29 

A 

Esc [ B 

Do 

1 

Esc 

[ 2 

9 ~ 

Ri ght-Arrow 

2B 

A 

Esc [ C 

Compose 

2 

Esc 

[ 1 

0 ~ 

Lef t-Arrow 

2D 

A 

Esc C D 

Print Screen 

3 + 

Esc 

[ 1 

2 ~ 

Keypad 0 

2F 

# 

0 

FA 

5 

Esc 

[ 1 

A ~ 

Keypad 1 

32 


1 

F6 

7 

Esc 

[ 1 

7 ~ 

Keypad 2 

35 

# 

2 

F7 

9 

Esc 

C 1 

8 ~ 

Keypad 3 

38 

# 

3 

F8 

B 

Esc 

[ 1 

9 ~ 

Keypad h 

3B 


A 

F9 

D 

Esc 

[ 2 

0 ~ 

Keypad 5 

3E 


5 

FIO 

F 

Esc 

[ 2 

1 ~ 

Keypad 6 

Al 

# 

6 

FIA 

1 1 

Esc 

[ 2 

6 ~ 

Keypad 7 

AA 

# 

7 

F17 

13 

Esc 

C 3 

1 - 

Keypad 8 

A7 

# 

8 

Fl8 

15 

Esc 

[ 3 

2 - 

Keypad 9 

AA 

# 

9 

F19 

17 

Esc 

[ 3 

3 - 

Keypad Dash 

AD 

# 

- 

F20 

19 

Esc 

[ 3 

A 

Keypad Comma 

50 


> 

F i nd 

IB 

Esc 

[ 1 

-- 

Keypad Period 

53 

# 

• 

1 nser t 

ID 

Esc 

[ 2 

- 

Keypad Enter 

58 

# 

(CR) 

Remove 

IF 

Esc 

C 3 


Keypad PFl 

59 

~ 

Esc 0 P 

Select 

21 

Esc 

C A 


Keypad PF2 

5C 

~ 

Esc 0 Q 

Prev Screen 

23 

Esc 

C 5 


Keypad PF3 

5F 


Esc 0 R 

Next Screen 

25 

Esc 

C 6 


Keypad PFA 

62 


Esc 0 S 

Up-Arrow 

27 ^ 

Esc 

[ A 


Break 

65 


not ret. 


Notes: * Compose key Esc sequence returned only by Rainbow 100 

+ Print Screen key Esc sequence returned only by Rainbow 100+ 
and lOOB 

These depend on Cursor Key mode and ANSII/VT52 mode 
# These depend on Keypad mode and ANSII/VT52 mode 
~ These depend on ANSII/VT52 mode 

Sequences shown are for ANSI I mode 
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MS-DOS 


This chapter contains two parts: 

• Part A describes the operation of the MS-DOS operating system 
(including its internal and external commands) 

• Part B describes the principle parts of the MS-DOS operating 
system 


Part A - Operation of MS-DOS 


3.1 OVERVIEW 

MS-DOS is an operating system for m i cro-computer s using Intel 8o86 and 
8088 microprocessors. An operating system is a program that controls 
the overall operation of a computer. It provides an environment 
within the computer that enables you to easily perform operations such 
as : 

• Starting a program 

• Copy i ng files 

• Displaying a directory of files 

• Simplifying programming 

The MS-DOS operating system provides functions for commonly-used 
operations and I/O operations that are hardware- i ndependent . Thus, 
you can write an application program to run under the MS-DOS operat i ng 
system without requiring a detailed knowledge of the computer's 
hardware. Such a program runs on any computers that can run the 
MS-DOS operating system, as long as the computer has the appropriate 
peripherals. The “DOS" in MS-DOS stands for Disk Operating System, 
which means that MS-DOS provides al 1 the logical operat i ons necessary 
for writing and read i ng files to and from disk storage dev i ces . 
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3 . 1.1 MS-DOS Operating System Versions 

The MS-DOS operating system has evolved through a number of versions. 
Microsoft's Version 2.0 of the MS-DOS operating system is the basis 
for digital's Version 2.01 and Version 2.05. 

The MS-DOS Version 2.01 operating system does not contain Winchester 
hard disk support; the MS-DOS Version 2.05 does. Other features were 
also added to the BIOS of Version 2.05* and several new utilities were 
added to its distribution diskette. Among these are: 

• MDRIVE, which lets you use excess RAM to be used as a fast, 
logical disk drive 

• RDCPM, which reads files from Rainbow CP/M- 86 / 8 O diskettes 

• MEDIACHK, which permits the checking of media to be disabled, 
resulting in faster disk operations 

• BACKUP, a utility for making and restoring backup copies of 
the Winchester hard disk 

Both MS-DOS operating system Version 2.01 and Version 2.05 run on the 
Rainbow 100, 100+, and lOOB, provided it has at least 128K bytes of 

RAM. Only Version 2.05 includes Winchester disk drivers. 

Programs written to run under the MS-DOS Version 2.01 operating system 
run under the MS-DOS Version 2.05 operating system. 


3.2 LOADING THE MS-DOS OPERATING SYSTEM 

DIGITAL supplies the MS-DOS operating system on a diskette. Such a 
diskette is called a system diskette. A system diskette contains the 
system files: 

• 10. SYS 

• MSDOS.SYS 

• COMMAND.COM 

These system files contain the MS-DOS operating system code. The 
outermost tracks of all MS-DOS-formatted diskettes store a loader 
program, and three data areas (for keeping track of files stored on 
the diskette). The number of tracks required to store the loader 
program and data areas yaries according to the capacity of a diskette 
track. Rainbow computer diskettes use about three and 1/5 tracks for 
this. 
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Files are stored on the remainder of the diskette. Non-system 
diskettes differ from system diskettes only in that they do not 
contain the three system files. 

The Rainbow computer contains a small ROM-resident routine that reads 
the first sector of the outermost track (track 0) of the diskette in 
the startup (BOOT) drive whenever you turn on or reset the system. 
This sector contains a small program that reads a loader program from 
the remainder of the reserved tracks into RAM and starts it executing. 
The loader program reads two “hidden" system files (MSDOS.SYS, 10. SYS) 
plus the file COMMAND.COM, from the diskette into RAM, and starts 
execution. This process is known as starting or BOOTing the system. 
10. SYS is loaded just above the 8088 interrupt vector space, and 
MSDOS.SYS, which contains interrupt handlers, service routines, 
buffers, control areas and installed device drivers, is loaded 
immediately above 10. SYS. 

The file C0MMAND.COM contains: 

• A “resident" part 

• A “transient" part 

The resident part is loaded Just above MSDOS.SYS and contains 
interrupt handlers for those interrupt types used by the MS-DOS 
operating system plus code to reload the transient part of the file. 

The transient part contains code for all of the internal commands and 
the batch file processor. It is loaded in the highest addressed RAM 
available in the system. The transient part of C0MMAND.COM: 

• I ssues the prompt 

• Reads the command from the keyboard or batch file 

• Executes the command itself (internal commands) or builds a 
command- 1 i ne 

• Loads a program file (external command) 

• Starts execution. 

The external command is loaded into the lowest available free memory. 
The MS-DOS operating system maintains a table of available memory, 
which keeps track of where each program is loaded. 

Whenever an application or external command finishes execution and 
returns control to the MS-DOS operating system, the resident part of 
C0MMAND.COM determines, by a check-sum process, whether the transient 
part needs to be reloaded. If necessary, it reloads the transient 
part before issuing its prompt. 
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Application programs are loaded in the area of memory between the two 
parts of COMMAND.COM. 

Figure 3“1 shows an MS-DOS memory map: 


3ffH 

OOOH 


Top of Available RAM 


COMMAND.COM 
(Transient part - 
May be overlaid by 
External Commands) 


256 Byte User Stack 
for .COM programs 


Externa 1 Command (s) 
.COM or .EXE f i les 


COMMAND.COM 
(Initial ization part) 

(Overlaid by Ext Cmds) 


C0MMAND.COM 
(Resident part) 


MSDOS.SYS 


10. SYS 


Interrupt Vectors 


Displays prompt 
Command I nterpreter 

Gets Cmd from Kbd/.BAT 
Builds command line 
Loads and Executes 
External Commands 
Executes Internal Cmds 
Processes Batch Files 


Contains Auto-Exec code 
Inits lowest Segment 
Address 


Reload Transient part 
Int. 23H (Ctrl/C exit) 
Int. 2^H (Fat. Err exit) 
Error handlers 

Buffers 

Control Areas 

Installed Device Drivers 

I nter rupt Handl ers 
Servi ce Rout i nes 
(Int 21H Functions) 


MS-DOS Interface to Hardware 


Figure 3“!^ MS-DOS Memory Map 
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3.3 DISTRIBUTION DISKETTE CONTENTS 

Table 3~1 lists the MS-DOS operating system files stored on the system 
d i skettes . 


Table 3~l5 MS-DOS Operating System Files on System Diskette 


Standard MS-DOS 

Files 


File name 

Funct i on 


COMMAND.COM 

MS-DOS Command Processor 


* MSDOS.SYS 

MS-DOS Operating System 


* 10. SYS 

Hardware-Operat i ng System li 

nterf ace 

EDLIN.COM 

Line Editor 


DEBUG.COM 

Debugger 


LINK.EXE 

L i nker 


CHKDSK.COM 

Checks d i skettes 


% F0RMAT.COM 

Formats diskettes 


SYS.COM 

Transfers System 


DISKC0PY.COM 

Copies entire diskettes 


REC0VER.COM 

Recovers diskettes 


PRINT.COM 

Print Spooler 


M0RE.COM 

Reviews Text 


S0RT.EXE 

Sorts Text 


FIND.EXE 

Finds a string in a file(s) 

or std input 

EXE2BIN.EXE 

Converts .EXE files to .COM 


FC.EXE 

Compares files 


Non-Standard MS- 

■DOS Files 


MASM.EXE 

Macro Assembler 


CREF.EXE 

Cross Reference Utility for 

MASM 


Files only on 

Rainbow computer MS-DOS V2.05 Diskette 

CONFIG.SYS 

System configuration file (Req'd by MDRIVE) 

MDRIVE.SYS 

Virtual Memory diskette 

MDRIVE.COM 

II II II 

BACKUP.EXE 

Hard disk Backup & Restore Utility 

MEDIACHK.EXE 

Enables/Disables Media Checking function 

RDCPM.EXE 

Reads CP/M Formatted diskette files 

README. HLP 

Addenda and Errata to Rainbow computer 
documentat i on 


* Denotes "hidden" files 

% Different levels of functionality in the two 
Rainbow computer MS-DOS versions 
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3.k COMMANDS 

The MS-DOS operating system uses the term "command" as both a verb and 
a noun. When MS-DOS issues a prompt such as "A>", it waits for you to 
type a command. This is the verb use. The code that performs the 
operation is called a command, it is the command processor part of 
the MS-DOS operating system that issues the prompt and invokes the 
program with the command name you typed. 

NOTE 

Any program stored as a diskette file is called an 
external command. This is because such a program is 
not internal to the operating system. It is a 
command, because its name must be given in response to 
the command prompt. 


3 .A.I Rainbow MS-DOS Version 2.05 Special Command Caveats 

The following section describes some caveats you should keep in mind 
as you use the MS-DOS operating system. 

FORMAT 

There are two formatting processes used with diskettes. The 
first, and most general, is physical formatting. This is the 
process whereby synchronizing data is placed on a newly 
manufactured diskette. This synchronizing data is required in 
order for the diskette controller circuits to read and write data 
to the diskette. The MS-DOS operating system, however, uses the 
term "formatting" to mean an entirely different process. This 
process initializes a blank, but physically-formatted diskette, 
with an area for storing the diskette directory and a table 
called the File Allocation Table (FAT). 

Both types of formatting must be done for MS-DOS diskettes. 
DIGITAL'S RX 50 diskettes are already physically formatted, but 
diskettes that have been damaged by exposure to magnetic fields 
may have to be physically reformatted. 

The MS-DOS Version 2.01 formatting program only initializes a 
blank diskette and creates the file allocation table (FAT). The 
MS-DOS Version 2.05 formatting program physically formats the 
diskette and then initializes it. (Use the FORMAT command's /I 
switch to format both ways). 

The syntax for the FORMAT command is: 

FORMAT d: [/S] C/l] C/V] 
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Also, the MS-DOS Version 2.05 FORMAT command does NOT format a 
diskette in the default drive. See the section entitled 
"External Commands" later in this chapter for further 
i nformat ion. 

The MS-DOS initialized Winchester disk partitions can also be 
MS-DOS formatted but not physically formatted. 

If you specify a volume label when the FORMAT program asks for 
one, you cannot later make this diskette into a system diskette 
using the SYS command. If you do this, the operating system 
displays an error message to the effect that there is no space on 
the diskette for system files. To make a system diskette, either 
format the diskette with the "/S" command option (with or without 
a volume label) or format the diskette without a volume label, 
then use SYS. 

The MS-DOS Version 2.05 operating system's FORMAT command also 
performs MS-DOS soft formatting on Winchester partitions 
previously created by the partitioning formatting utility 
distributed with the Winchester hardware option. However, the 
"/I" switch for physically formatting the Winchester disk is 
inoperative, and does nothing if invoked. Hard formatting a 
Winchester disk can only be done with the above mentioned 
partitioning formatting utility. 

DISKCOPY 

Diskettes receiving the files copied by the DISKCOPY command must 
have been previously "physically" formatted, not MS-DOS 
formatted. Diskettes that are specially formatted, such as the 
Lotus 1-2-3 system diskettes, should NOT be copied using the 
DISKCOPY command, because their special features can be 
corrupted . 

Use a backslash character when using path names. 

Pressing Ctrl/C stops a program if the running program notices 
the key sequence or if it uses system functions to test for the 
key sequence. When BREAK is on, all system functions include 
this test. 

The command processor can read commands from the disk file as 
well as accepting them from the keyboard. This file must have an 
extension of .BAT. The file contains several MS-DOS command 
lines, each of which are executed by the command processor once 
you type the file name at the prompt. 
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The command processor has also been arranged to automatically 
search the BOOT disk for a batch file with the name 
"AUTOEXEC.BAT" immediately after the BOOT operation. If one is 
found, the file is executed as if you had entered the name 
AUTOEXEC at the prompt. However, the normal prompts for TIME and 
DATE are bypassed. If your system expects to use TIME or DATE 
during the session, the AUTOEXEC command file should include 
entries for the TIME and DATE commands. 

You can use the following commands in command files: 

• ECHO 

• FOR 

• GOTO 

• IF 

• PAUSE 

• REM 

• SHIFT 


3.^.2 Generic Commands 

This sections describes the external MS-DOS commands unique to the 
Rainbow computer. 


BREAK 


Most application programs that expect to use Ctrl/C use the 
system function provided for this purpose. It is not necessary, 
in this case, for the operator to first invoke the BREAK OFF 
command . 


CHKDSK 

Do NOT use the CHKDSK command with the /F option for an IBM 
diskette under Rainbow computer's MS-DOS Version 2.05 operating 
system. If the IBM diskette is double-sided, it can be 
destroyed . 
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COPY 


You can use character I/O device names (such as PRN, AUX) as file 
names for the COPY command. 

When copying from a serial I/O device (for example, from another 
computer by means of the AUX device (communications port) or the 
PRN device (printer port)), the operation does not work as 
expected. Instead, carriage return characters are removed from 
the data stream, characters are not echoed to the input device, 
and either a single Ctrl/Z or two successive carriage-return 
characters ends the COPY operation. 


CITY 


The CITY command changes the device used for interactive entry by 
the operator, but does not change any device names. For example, 
the command CITY AUX causes all operator commands to be expected 
from the AUX port. If another terminal, such as a VTIOO, is 
connected to the communications port (AUX), it can be used for 
controlling the Rainbow computer. However, if, while doing this, 
you enter the command COPY file name CON, the file is displayed 
on the Rainbow computer's screen, not on your VTIOO. Similarly 
the command COPY CON file name places whatever is typed on the 
Rainbow computer's keyboard into the file, not the VTIOO' s 
keyboard. 


ECHO OFF 

The ECHO OFF command Is echoed. 


EXE2BIN 

Use this external command to convert .EXE files into .COM files. 
The 


GOTO 


A Batch-F i 1 e 1 abel i s 
characters fol lowi ng 
following a GOTO must 


defined by a leading colon (":"). The 
the colon define a label. The characters 
BE a label. They do not define the label. 
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PRINT 


The file using the /C switch, and ail file entries following it 
in the print queue, are removed from the print queue until you 
type a /P swi tch . 

The first time you use the PRINT command after starting the 
MS-DOS operating system, it prompts you for the name of the list 
device, the default being PRN (also shown in the prompt). Just 
press the <Return> key, unless you wish to specify some other 
port. 


RECOVER 

RECOVER attempts to read and process data from a bad diskette. 
The data may be bad and can cause unpredictable, or incorrect, 
results. DIGITAL recommends, however, that you use this command 
only as a last resort to recover files from a bad diskette. 


SORT 


Use the SORT command to sort any text file. Be sure that each 
line has the same fixed-length fields. SORT can be pipelined for 
multiple-field sorts, such as for DATE and TIME. When performing 
multiple-field sorts, the secondary, or least significant sorts, 
must be performed first, and the primary, or most significant 
sorts, last. 

Figure 3“2 shows a diskette DIRectory sorted by both date and 
time. The two lines giving the number of files and the volume 
label are included in the sort process. if the last sort had 
been- from column 2k instead of 22, the line containing 40^*48 
would have been somewhere within the sorted list. The command 
was invoked from the B drive because SORT creates temporary files 
on the default diskette and the diskette in the A drive was write 
protected. The SORT command was on the diskette in the A drive. 
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B>D I R A : I A : SORT/+3^* | A : S0RT/+22 
Directory of A:\ 


LINK 

EXE 

42368 

1-06-83 

4:36p 

FIND 

EXE 

5796 

1-14-83 

6:35 p 

MORE 

COM 

4364 

1-14-83 

6:42p 

RECOVER 

COM 

2277 

2-01-83 

2:22p 

EXE2BIN 

EXE 

1649 

2-01-83 

9:19a 

FC 

EXE 

2553 

2-01-83 

9:36a 

DEBUG 

COM 

11764 

2-01-83 

10:13a 

DISKCOPY 

COM 

1419 

2-14-83 

4:39 p 

EDLIN 

COM 

4489 

5-17-83 

4:31p 

SORT 

EXE 

1360 

5-17-83 

4:34p 

CONFIG 

SYS 

20 

9-17-83 

6:27 p 

PRINT 

COM 

3335 

9-18-83 

1 1 :58p 

CHKDSK 

COM 

6330 

9-19-83 

12:00a 

SYS 

COM 

850 

9-26-83 

5:04p 

COMMAND 

COM 

15925 

9-26-83 

11:21a 

MDRI VE 

COM 

873 

9-27-83 

10:38p 

MDRI VE 

SYS 

953 

9-27-83 

1 1 :46p 

FORMAT 

COM 

19405 

10-07-83 

12:27p 

MEDIACHK 

EXE 

1396 

10-10-83 

9:25a 

MASM 

EXE 

77440 

10-12-83 

3:36p 

CREF 

EXE 

13824 

10-12-83 

3:39 p 

BACKUP 

EXE 

72534 

10-13-83 

5:55 p 

RDCPM 

EXE 

9194 

10-14-83 

9:45a 

README 

HLP 

18238 

10-17-83 

7:42a 

2l» F 

i 1 e (s) 

bytes 

free 

Volume ir 

1 drive 

A is MS 

-DOS V2.05 


gure 3“2: Sorted Diskette Directory 
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3.^.3 MS-DOS Version 2.05 Additional Commands 
RDCPM 


The README. HLP file, stored on the MS-DOS Version 2.05 
distribution diskette, describes the RDCPM command. 

RDCPM DIR B: [f i lename.typ] 

This command displays the directory of files on the 
CP/M- 86 / 8 O diskette in drive B; matching the file 
specification. No default is allowed for the drive. The 
default file specification is *.*. 

RDCPM READ B: [f i 1 ename. typ] [A:] [path] 

This command copies all files on the CP/M diskette in drive 
B: matching the file specification to the directory 

described by "path" on MS-DOS drive A:. No default is 
allowed for B:. The default file specification is *.*. The 
default drive is the current MS-DOS default drive. The 
default path is the current directory. If the path is 
specified, it must exist. 

RDCPM TYPE B: [fi lename.typ] 

This command types the contents of files on the CP/M 
diskette in drive B: matching the file specification. No 

default is allowed for B:. The default file specification 
is . '< . 


MED! ACHK 

The MS-DOS Version 2.05 operating system BIOS contains code that 
checks the type of disk media in a disk drive on every read and 
write operation to that drive. This checking takes time to 
execute, and on large files can slow down operation. MEDIACHK is 
a program that disables, or enables, this media checking 
function. When disabled, COPY operations proceed faster than 
when they are enabled. 

MEDIACHK 

This command displays the current setting 
MEDIACHK ON 

This command turns MEDIACHK on 
MEDIACHK OFF 

This command turns MEDIACHK off 
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3*5 DEVICE NAMES 

File names beginning with CON, AUX, LSI, PRN, and NUL are illegal 
because they are used by the MS-DOS operating system to identify the 
following character I/O devices: 

AUX - Communications Port 

AUX2 - Extended Communications Port 

CON - Console Device (Keyboard/Video Monitor) 

PRN - Printer Port 

When you use these device names, you need only type the name, although 
the MS-DOS operating system will also accept them followed by a colon. 


3.6 EDITING AND FUNCTION KEYS 

The MS-DOS operating system lets you easily edit command lines you 
have entered at the keyboard. EDLIN, the MS-DOS line editor, provides 
these same editing functions. EDLIN is described in the users manuals 
that came with your MS-DOS operating system kit. This section 
describes some additional information on EDLIN. 

When editing an existing file, EDLIN changes the extension of the 
original copy to .BAK. If two files have the same name, it is 
difficult to determine which file was the original of the .BAK file. 
Therefore, avoid giving files the same file name. 

To insert an '’ESC" character, use the <lnterrupt> key, rather than the 
<ESC> key. 

The syntax for (C) opy includes a comma between the line number and the 
"C" . Th i s i s opt i onal . 

When in (l)nsert mode, pressing Ctrl/C returns to the EDLIN command 
prompt. A Ctrl/Z sometimes also exits the (l)nsert mode. The latter, 
however, usually must be followed by pressing the Return key. If the 
Ctrl/Z is immediately followed by other characters before the Return, 
the Ctrl/Z code is entered in the text, and (l)nsert is not stopped. 
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Part B - Principle Parts 


3.7 MS-DOS PROGRAMS AND ROUTINES 

The programs and routines that make up the MS-DOS operating system are 
divided into three major functional areas: 

1. COMMAND.COM - Command Processor 

The file COMMAND.COM is the command processor. It is the 
part of the MS-DOS operating system that accepts, interprets, 
and acts upon the commands you enter on the console keyboard. 
It recognizes and executes the "internal" commands, and loads 
"external commands" (programs) and starts execution. It is 
also called an MS-DOS "shell." 

2. DOS - Disk Operating System 

DOS, contained in the file MSDOS.SYS, performs logical I/O 
and disk operations, either in response to requests by the 
command processor's internal commands, or in response to your 
external commands. DOS also contains a number of useful 
"system calls," or functions. These functions provide disk 
and other I/O operations to programs through a standardized 
access method, making programs transportable from one system 
to another, and greatly simplifying their preparation. 

3. BIOS - Basic Input - Output System 

The Basic Input - Output System (BIOS) contains routines that 
control the hardware of the computer system. These are 
custom written for each system and are contained in the file 
10. SYS. Included are routines that: 

• Display a character on the logical console device 

• Send a character to the logical printing device 

• Read a record from a disk 

• Wr i te a record to a disk 

The DOS routines and system functions access these BIOS 
routines to perform all 1/0 

Generally, the command processor and DOS portions of every MS-DOS 
operating system are byte-f or-byte, bit-for-bit identical, as provided 
by Microsoft, while the BIOS is customized for the system's particular 
hardware. 
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3.7*1 Command Processor 

After you start the MS-DOS operating system, a prompt is displayed on 
your screen, such as “A>“. This tells you that the MS-DOS operating 
system is ready to receive a command, and that default disk operations 
are to be performed on the A: drive. The command processor displays 
the prompt, and either executes, or loads and starts, the command. 


3.7*2 Command Execution 

When you type a command name at the keyboard, the command processor 
evaluates it. First, it determines whether it i s an internal command. 
If it is an internal command, it is immediately executed. If it is 
not, it attempts to find a file having the specified name on the 
specified drive, or if no drive was specified, on the default drive. 
The command processor expects that the file type associated with the 
file name is to be either .COM, .EXE, or .BAT, and searches for them 
in that order. If a command file, with the name specified in the 
command line, cannot be found, the operating system displays the 
message “Invalid Command,'* and issues another prompt. 

When the command processor finds the specified .COM or .EXE file, it 
reads the file into RAM. Files of both types are usually loaded into 
the lowest available memory. 


3.7.3 Program Segment Prefix 

After loading an external command file, the command processor 
initializes the first 256 bytes of the program segment with several 
values for use by the loaded program. These first 256 bytes are 
called the Program Segment Prefix (PSP). Therefore, all application 
programs must begin at offset lOOH. One of the DOS System functions 
(EXEC) can also be invoked by an application program to load another 
program file, and it, too, has a PSP. 

After initializing the Program Segment Prefix, the command processor 
starts program execution. Once the external command is started, the 
command processor is not used again until the program terminates. 

The Mi crosof t Operat i ng System Programmer ' s Reference Manua 1 provides 
a detailed description of the PSP and its contents. (This manual is 
contained in this kit.) 
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The DOS (Disk Operating System) constitutes the heart of the MS-DOS 
operating system. It performs all logical disk I/O operations, 
calling on the BIOS routines to read and write. It also provides a 
large number of useful system functions, which application programs 
can call to do disk and other I/O operations. 


3.8.2 Disk Drives 

The MS-DOS operating system can access several disk drives. Each is 
identified by a single letter, "A," "B," “C,“. Disk drives can be 
either actual physical drives, or "virtual" or "logical" drives, such 
as portions of one large capacity hard disk. 

Hard disks can often store more data than can be accommodated by one 
MS-DOS drive name, so they are subdivided into several partitions. 

Each partition can store a portion of the total disk space. Each 

partition is then given a "logical" drive name. 

A logical drive can even be a part of RAM. The MS-DOS Version 2.05 

operating system includes a utility called MDRIVE that sets up an area 
of RAM as a fast access memory disk. Files can be COPYed in and out 
of it, as with any other logical drive. MDRIVE is useful when running 
programs such as editors. Of course, it is necessary to COPY files 

into it before editing and to COPY any that have been modified back to 

a physical disk before turning off the power. 


3.8.3 Disk Files 

Central to the MS-DOS operating system is its method for storing and 
accessing data files on disks. The MS-DOS operating system was 
originally written to work with diskettes, and it still does. 
However, it also works with hard disks. 
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3 . 8.4 Disk Organization 

The MS-DOS operating system reserves one or more of the first tracks 
of a disk for storing a loader program. These first track are called 
the "system tracks." You us all remaining tracks for storing files. 

System diskettes contain the MS-DOS operating system in three files: 

• 10. SYS, 

• MS-DOS. SYS 

• COMMAND.COM 

The two .SYS files are hidden. They are not displayed by the DIR 
command . 

The MS-DOS operating system writes data to disk files in "logical" 
records, which can be any length, but are usually 128 bytes each. 
Data files are written wherever there are empty locations, and there 
can be many locations containing portions of a file. Entries are made 
in a Directory and a File Allocation Table for each file on a disk 
that tell the MS-DOS operating system where the file is stored on the 
disk. 


3 . 8.5 Clusters 

Because even a small diskette can store a great many 128 byte records, 
it is impossible to have the directory and File Allocation Table keep 
track of each one. Instead, MS-DOS divides a disk's capacity into 
larger groups, called "clusters," that contain several logical records 
each . 

The data storage area of each disk is addressed in terms of these 
clusters. They are numbered with zero at the beginning of the data 
portion of the disk and "spiral" inward with increasing cluster 
numbers through the remainder of the disk. It is the number of 
clusters containing a file's data that are stored in the disk's 
directory and File Allocation Table. 

The first few clusters on each disk are reserved to store its 
directory, the number depending upon the capacity of the disk and 
cluster size. Disks can have capacities ranging from less than lOOK 
bytes to many megabytes. Cluster sizes can be 5^2, IK, 2K, 4K, or 8K 
bytes. The Rainbow computer's MS-DOS RX 50 diskettes use a cluster 
size of 512 bytes, while the Winchester drives use a cluster size of 
either 2K or 4K bytes, depending on the size of the partition. The 
first two clusters on the Rainbow computer's RX 50 diskettes are 
reserved for the Directory. 


3-17 



MS-DOS 


Each MS-DOS disk contains an ID byte to identify the disk type. 
MS-DOS Version 2.05 determines, through this byte, the characteristics 
of the disks to be read. 


3 . 8.6 Directory 

Figure 3~3 shows the contents of the first eight directory entries for 
MS-DOS Version 2.05 system diskette. These are stored in the first 
logical record of the first cluster. The left side of the figure 
shows the contents in hex notation, while the right side displays the 
same data in ASCII (non-di splayable bytes are shown as dots). 


Byte Contents 

(Hex) 

0000 if9i»F202020202020 
0010 00000000000091 BA 

0020 4D53^^^F53202020 
0030 000000000000864C 

0040 434F4D4D414E4420 
0050 000000000000AF5A 

0060 4D532D444F532056 
0070 0000000000006074 

0080 434F4E4649472020 
0090 0000000000006C93 

OOAO 4D44524956452020 
OOBO OOOOOOOOOOOOD9BD 

ooco 4445425547202020 
ooDo 000000000000 A 551 

OOEO 43484B44534B2020 
OOFO 0000000000001300 


(Hex) 


5359532700000000 

4807020000300000 

5359532700000000 

3C071A00E6420000 

434F4D2000000000 

3A073CO0353EO000 

3230350800000000 

4E07000000000000 

5359532000000000 

31075000 14000000 

5359532000000000 

3 BO 75 DOOB 903 OOOO 

434F4D2000000000 

41065F00F42D0000 

434F4D2000000000 
330776 OOBA 180000 


Contents (ASCII) 


10 SYS'.. 

........ H....0 

MSDOS SYS'.. 

L < B 

COMMAND COM . . 
7 • < 

MS-DOS V 205 ... 
't N 

CONFIG SYS .. 

1 _ ] 

MDRIVE SYS .. 


DEBUG COM .. 
Q A._. .- 

CHKDSK COM .. 

........ 3 . ^ ... 


Figure 3~3! MS-DOS Directory Entries 
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3.8.7 Directory Fields 

Every file on a disk, whether a hard disk or diskette, has an entry in 
either the root directory or a subordinate directory. Subordinate 
directories are actually files that have a directory entry in their 
“parent’s" directory. Each directory entry contains thirty-two bytes. 

As illustrated in Figure the first byte tells MS-DOS if it is 
active or not, that is, whether it contains information about a file. 
If not, this byte is either OOH or E 5 H. 


BYTE OFFSET (HEX) 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

r 

O’ 







‘S’ 

‘Y’ 

‘S’ 

27 

00 

00 

00 

00 



r 

“II 

A ^ 





TYPE 





Dcroc 

D\/c:n 


— 

1 

riLIZINAMVIL: 





^ nizoLzn V t.i_/ ^ 


ACTIVITY BYTE ^ ^ 


00 = DIR ENTRY NEVER USED 
2E = ENTRY IS FOR A DIRECTORY 
IF SECOND BYTE IS ALSO 2E 
CLUSTER # IS FOR PARENT DIR. 

(0 CLUSTER # INDICATES PARENT IS ROOT.) 
E5 = DELETED DIRECTORY 
ALL OTHERS = FIRST LETTER OF FILENAME. 


ATTRIBUTES 


7 6 5 4 3 2 

1 0 

L 

□ 


_ 

□ 


_ 

□ 


L 


READ ONLY 
HIDDEN FILE 
SYSTEM FILE 
VOLUME LABEL 
SUB-DIRECTORY 
ARCHIVE BIT 
NOT USED 


10 11 12 13 14 15 


BYTE OFFSET (HEX) 

16 17 18 19 1A 


IB 1C ID IE IF 


00 

00 

00 

00 

00 

00 

91 

BA 

48 

07 

02 

00 

00 

30 

00 

^ RESERVED ► 

TIME 

DATE 

FIRST 

CLUSTER 

FILE SIZE 

/D\/Tr“0\ 


00 


NOTE: ALL DATA STORED IN LS, RS SEQUENCE 


BU-2290 


Figure Format of a Directory Entry 


When a disk or diskette Is newly formatted, all directory entries have 
their first byte set to zero to indicate that they have never been 
used. When the operating system writes files to the disk or diskette, 
the first empty directory entries are always assigned first. 
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When the operating system deletes a file, the first byte of its 
directory entry is changed to an E 5 H. This arrangement speeds up 
directory search operations. 

If a directory entry is encountered whose first byte is zero, the 
remainder of the disk or diskette must be empty. This first, or 
activity byte, is 2 EH if the file is a sub-directory. Further, if its 
first two bytes are 2 EH, the first cluster field of the directory 
entry contains the cluster number where the "Parent's" Directory is 
stored. This value is zero if the parent is the root directory. 

If a directory entry is active, the first byte contains the first 
letter of the file name. 

For active directory entries: 

Byte(s) Contents 

OO-OA File name and file type 

OB Attribute flags 

OC -15 Reserved by MS-DOS 

16-17 Time that the file last written 

18-19 Date that the file last written 

lA-lB First cluster where file is stored 

(contained in least three significant nibbles) 

1 C- IF Number of bytes in the file 

When a file is DELeted, all but the first byte of its directory entry 
remains on the disk. All file allocation table entries containing 
cluster numbers allocated to the deleted file are reset to zero. This 
releases the disk space for use by other files. This also generally 
makes it impossible to reclaim a deleted file, unless the file was 
small enough to be contained in the single cluster whose address is in 
the directory entry. Small files can sometimes be reclaimed because 
the number of the first cluster assigned to the file is still in the 
deleted directory entry. This is only possible if the directory entry 
was not reused for a new file by an intervening COPY or other 
file-creating activity. 
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3 . 8.8 File Attr i bates 

You can assign MS-DOS files one or more of six possible attributes, 
such as “Read-Only" or “Hidden." Assign these attributes by setting 
the appropriate bits of the attribute byte in offset OBH of the 

directory entry, using System Function A 3 H. The meaning for each bit 

of OBH fol lows: 

Bit Meaning When Set 

7 Not used. 

6 Not used. 

5 Archive bit. Set “On" each time file is written or closed. 
h File is a Sub-Directory. 

3 Directory Entry is Volume Label, not file. If this bit is 
set, all other bits are ignored. 

2 File is “System," does not display in Directory 

1 File is “Hidden," does not display in Directory 

0 F i le i s Read-Only. 

The archive bit is useful for programs that make backup copies of 

files. All file write and close operations set this bit to On (1). A 
backup, or "archiving" program, should reset it to Off (O) after 

successfully copying the file. In this way, the backup program can 
determine which of the files have been changed since the last backup 
copy was made, and limit its copying to these. 

The BACKUP utility on the MS-DOS system diskette has an option that 
copies only files with the archive bit set. 


3 . 8.9 Fi le A1 location Table (FAT) 

The MS-DOS operating system maintains a special File Allocation Table 
(FAT) on each disk. The FAT stores the cluster-numbers allocated to 
files on the disk. Generally, disks are arranged with at least two 
copies of this table as insurance against accidental loss. If this 
table cannot be read, the files stored on the disk cannot be located, 
even though their data may be intact. 

The FAT stores each cluster number in three half-byte "nibbles." This 
allows a maximum of 4096 clusters per disk file, because twelve bits 
can uniquely identify only 4096 locations. The first byte of the FAT 
usually contains a disk identifier. 
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Rainbow Disk Identifiers 

V2.01 V2.05 


Diskette FC FAN 

Winchester Hard F8H 

Disk 

Rainbow computer diskettes have been assigned FAH by DIGITAL. 
Microsoft has assigned bytes FC,FDH,FEH, and FFH for systems disk 
conf i gurat i ons . 

The second and third bytes of the FAT are always FFH. They assist in 
identifying the FAT, and also insure that the first FAT cluster entry 
begins on a byte boundary. Remember that it takes three bytes to 
store two FAT entries. 

The first two clusters of a Rainbow computer's RX50 diskette are 
always assigned to the directory itself, so the first cluster number 
assigned to a file is number 02, because cluster numbers begin with 
zero. 

Figure 3"5 shows the first 128 bytes of the FAT from the same MS-DOS 
Version 2.05 system diskette whose directory entries are shown in 
Figure 3 " 3 - Notice that the three-nibble cluster entries appear mixed 
up. This is the way they appear on the diskette when the FAT is 
examined using DEBUG. When the FAT is read by the MS-DOS operating 
system, however, they are interpreted as illustrated in Figure 3~6. 
When a diskette is initialized by the FORMAT program, all FAT entries 
are set to zero to indicate that the cluster location is not assigned 
to a file, and that it is suitable for storing data. Any clusters 
spanning diskette defects have their FAT entries set to FF7H. The 
MS-DOS operating system skips over such clusters automatically, 
allowing the remainder of the diskette to be used. 

Byte Contents (Hex) 

(Hex) 

0000 FAFFFFO 3 AOOOO 56 O 0007800009 A 0000 B 
0010 COOOODEOOOOFOOOl 1120011340011560 
0020 01 178001 I 9 FOFFIB cool IDEOOl 1 F 0002 
0030 2120022340022560 O2278OO229AOO22B 
0040 C0022DE0022F0003 3120033340033560 
0050 O 3378 OO 339 AOO 33 B F0FF3DE0033F0004 
0060 4120044340044560 0447800449A0044B 
0070 C0044DE0044F0005 5120055340055560 


Figure 3~5: Beginning of File Allocation Table (FAT) 
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Byte 

(Hex) 


0000 FAFFFFO 340 OOO 56 O OOO 78 OOOO 9 AOOOOB As 
0000 FAFFFFOO 3 OOAOO 5 O O 6 OO 7 OO 8 OO 9 OOAOO As 

0010 COOOODEOOOOFOOOl 11200113^0011560 As 
0010 B00C00D00E00F01001 IOI 2 OI 3 OIAOI 5 OI As 


stored on diskette 
i nterpreted 

stored on diskette 
i nterpreted 


Figure 3~6: Interpreted File Allocation Table Entries 


The first cluster number assigned to a file is contained in the file's 
directory entry. When this cluster becomes filled with data, the 
MS-DOS operating system scans the FAT table from the top until it 
finds a table entry of zero, indicating an empty cluster. It then 
places the number of this newly assigned cluster into the FAT location 
of the cluster pointed to by the directory entry. Similarly, whenever 
a new cluster is assigned to a file, its number is placed into the FAT 
location for the previous cluster. In this way a file is linked from 
cluster to cluster. The FAT entry for the last cluster of a file is 
set to any value from FF8H through FFFH. 

The Mi crosof t Operat i nq System Programmer ' s Reference Manual describes 
these file and directory operations in detail. (This manual is 
contained in this kit.) 


3 . 8.10 Sector Translation 

Some computer systems store data on a disk using an interlace, that 
is, sectors are written in a non-cont i guous sequence around a track. 
This is because time is required for computing and getting ready for 
the next sector's read or write operation. If this next sector's data 
were to be written to the disk's next physical sector, the latter 
might have already passed under the read head, thereby requiring a 
full revolution of the disk to access it. To avoid this, the record 
is written at a physical sector, separated by one or more intervening 
sectors. This interlacing can be accomplished in either of two ways: 

• One method is to format the disk with interlaced physical 
sector numbers, such as in the sequence 1 ,3>5>7>9>2,A,6,8, 10. 

• The other way is to format the physical sectors sequentially 
and do a logical translation of the desired sector number 
before performing the physical read or write operation. 
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• When this method is used, the logical sector number specified 
by the MS-DOS operating system to the disk-driver is 
translated to obtain the correct physical sector. Files are 
written on Rainbow computer RX50 diskettes using this latter 
scheme, that is, in the sequence of physical sectors 
1,3. 5. 7. 9, 2, it, 6, 8, 10. 

• For the hard disk drive, the sequence of physical sectors is 

1,8, 15, 6, 13, 11 *2, 9, 0,7, 1^,5, 12, 3, 10. 


3.8.11 File Control Blocks 

When a program needs to read or write data to a file, certain 
information about the file must be passed to the MS-DOS operating 
system so that it can “open” the file, (locate its directory, and 
access its data records.) Such information can be passed to the MS-DOS 
operating system using a File Control Block (FCB) . 

A FCB consists of a 3& or A3“byte area in memory. It can be located 
anywhere the program finds convenient. The command processor sets up 
one or two default "unopened*' FCBs in the Program Segment Prefix when 
a file is loaded, for the convenience of the programmer. 

FCBs are either "unopened" or "opened." An "unopened" FCB must be set 
up before an "open" system function is executed. It need only contain 
file ID information (drive, file name, and file type). All other 
bytes are usually set to zero. The offset relative to DS of a file's 
FCB is placed by the program into the DX register prior to invoking 
the desired MS-DOS disk function. The "open" system function locates 
the file's directory and copies the remaining FCB fields from it for 
use by subsequent file operations. The FCB thereby becomes an 
"opened" FCB. 

After all file operations are complete, the application program should 
"CLOSE" the file. The CLOSE operation copies the newly updated data 
from the FCB back onto the disk's directory and FAT. Closing is not 
necessary if only Read operations were performed, because the 
directory and FAT were not changed. If the close operation were 
omitted after data had been written to the file, however, the 
file-size field of the directory is not updated and would not agree 
with the FAT. 
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3 . 8.12 Extended File Control Blocks 

An extended FCB is required when creating or searching for directory 
entries of files having special attributes. The extension consists of 
a seven byte prefix appended to the FCB. 

Byte(s) Contents 

7 FFH 

2-6 OOH 

1 Attributes (See above) 


3 . 8.13 Wi 1 dcards 

When the MS-DOS operating system searches the directory of a disk for 
a matching file name, it accepts as a match any character in those 
positions of the FCB‘s file name and file type that contain question 
marks ("?"). Asterisks are expanded to question marks throughout the 
remainder of the file name and/or file type fields by the command 
processor and by system function 29H. This “Wild Card" feature makes 
multiple file operations possible. 


3.9 BIOS 

The BIOS is that part of the MS-DOS operating system that directly 
controls the hardware of the system. Each I/O device is controlled by 
a “driver." The standard drivers are contained in the file 10. SYS, one 
of the two system files found in all MS-DOS implementations. Certain 
features and functions are required by the MS-DOS operating system, 
since the command processor and the MS-DOS operating system use the 
I/O drivers provided in 10. SYS for all I/O, and they must be able to 
properly interface to it. 


3 . 9.1 Serial I/O 

3 . 9 . 1.1 Logical and Physical Device Assignments - The generic MS-DOS 
operating system communicates with three logical, serial 1/0 devices: 

• Console (CON:) 

• Auxi 1 i ary (AUX:) 

• Print (PRN:) 

The names in parentheses are the names the MS-DOS operating system 
recognizes as logical devices. 
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The Rainbow computer's MS-DOS implementations assign the 
keyboard/video monitor as the CON device, the communications port as 
the AUX device, and the printer port as the PRN device. In addition, 
they provide an additional device driver called AUX2 to the optional 
extended communications port. 

The generic MS-DOS operating system also includes a CLOCK as one of 
its standard devices, for which there is a driver in 10. SYS. 

The MS-DOS operating system lets you install additional, or 
alternative, device drivers. All that is necessary is for the desired 
driver to be on the system diskette as a file, and its name contained 
in a batch text file named CONFIG.SYS. When you start the operating 
system, it looks to see if the CONFIG.SYS file exists on the diskette, 
and if so, loads all drivers named. If these have the same name as a 
default driver, they preempt the latter. In this way special drivers 
can be easily loaded for new I/O operations. 

The Mi crosof t Operat i nq System Programmer ‘ s Reference Manual describes 
the rules for writing new device drivers and the operations available 
through the CONFIG.SYS file. (This manual is contained in this kit.) 


3 . 9 * 1 *2 Cross CPU Communications - The Z80A handles all diskette I/O 
in the Rainbow computer. Whenever the disk driver of MS-DOS is 
called, it calls the Z80A to perform the actual operation. The 
routines for these operations are contained in the Z80A's private RAM, 
having been placed there during the loading operation. 


3 . 9 * 1 *3 IBM Diskettes - The I/O drivers of MS-DOS Version 2.01 and 
Version 2.05 operating systems automatically identify and read RX50, 
IBM-8 and I BM-9 sectored single sided diskettes, and VTI 80 diskettes. 
MS-DOS files from any of the four types of single-sided diskette can 
be both read and written. However, data written to IBM diskettes is 
usually unreadable by the IBM PC, because the narrow head of the RX50 
cannot fully erase the wide data tracks of these diskettes. 
Therefore, writing to IBM diskettes is not recommended. If it is 
absolutely necessary to write to an IBM diskette, try formatting a new 
diskette on the IBM drive, and COPY the Rainbow computer file onto it. 
Once you are able to read such a file on the IBM PC, COPY it to 
another IBM diskette for safekeeping. 
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3.9*1 MDRIVE - The Rainbow computer's MS-DOS Version 2.05 operating 
system includes a new device driver that can utilize some of available 
RAM as a logical disk drive. The system diskette contains a program 
called "MDRIVE.COM" You can use MDRIVE to set up this logical disk 
drive. Memory is assigned in groups of 6 AK bytes. MS-DOS can read 
and write files to this "disk" the same as it does to any real disk. 
The advantage is that files can be accessed quickly, because they are 
already in RAM. 

You need at least I96K bytes of RAM to use MDRIVE, in which case you 
have one 6 AK block of RAM used as a logical drive. Files to be 
accessed must be COPYed into and out of the MDRIVE before and after 
use. MDRIVE stores the number of 6 AK blocks in MDRIVE. SYS, which is 
referenced in CONFIG.SYS through the DEVICE statement. (You must 
maintain CONFIG.SYS.) The drive name is the next available drive 
letter (E - I). For example, if you have 1 hard disk partition (drive 
E:) , then MDRIVE is drive F: . 


NOTE 

You must always configure MDRIVE from the drive that 
you are going to start the operating system from. 


3.10 SYSTEM FUNCTIONS 

In addition to reading and writing disk files, the MS-DOS operating 
system provides some 80 different system functions for performing I/O 
and other tasks. Application programs can use and invoke these system 
functions. Generally, the system functions are invoked by loading 
parameters into registers and invoking interrupt 21 H. Chapter 1 of 
the Mi crosof t MS-DOS 0 . S . Programmer ' s Reference Manua 1 describes 
these system functions, and how to invoke them. (This manual is 
contained in this kit.) 


NOTE 

The MS-DOS operating system does not generally 
undertake to save any CPU registers when performing 
the system functions. Therefore, application programs 
must save the contents of those registers that need 
preserving BEFORE calling the function, and then 
restore them afterwards. 
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3 . 10.1 I/O Programming 

The MS-DOS Version 2.05 operating system includes several additional 
system functions that: 

• Provide enhanced serial I/O control 

• Permit application programs to control the ports without the 
need for programming at the hardware level 

You need to know how the MPSC is programmed as a prerequisite to 
understanding the serial I/O functions, as they all relate to MPSC 
programming. This information is described in: 

• The Rainbow CP/M- 86 / 8 O VI .0 Tech Doc K i t (order number 
QVO 43 -GZ) . (This kit contains information about the Rainbow 
100 computer.) 

• The Ra i nbow MS-DOS V2 .01 Techn i ca 1 Doc K i t (order number 
QVO 25 -GZ) . (This kit contains information about the Rainbow 
100 computer.) 

• The Rai nbow 100+/100B Techni ca 1 Doc K i t (order number 
QVO 69 -GZ) . 

• The Rainbow Extended Communication Option Programmer ' s 
Reference Gui de (order number AA-V172A-TV) . 

Chapter 5 provides details of these additional System Functions. 


3.10.2 Interrupt Types 

The 8088 interrupt types used by the MS-DOS operating system include 
several that are also used by the Rainbow computer's hardware and 
firmware. To resolve this conflict, hardware interrupts 20H through 
27 H are reassigned to other types. MS-DOS Version 2.01 includes a 
special routine in the interrupt handlers of those interrupts common 
to both the hardware and the MS-DOS operating system. This routine 
determines whether the interrupt was generated by the hardware or by 
software. If it determines that hardware generated the interrupt, it 
issues a software interrupt to the alternate interrupt type. (See 
Table 3"2.) 
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Table 3~2: Rainbow Computer MS-DOS Interrupt Vector Assignments 


Function 


Interrupt Type 
(Hex) 



V2. 

01 

V2. 

05 


100 

100+ 

lOOB 

100 

100+ 

lOOB 

8088 Processor 

Divide by zero 

0 

0 

0 

0 

Single step 

1 

1 

1 

1 

NMI used for Memory Parity 

2 

2 

2 

2 

error or 8087 error 

Break point instruction 

3 

3 

3 

3 

Overflow 

if 

if 

4 

4 

Hardware 1 nterrupts 

Video refresh 

ifO 

ifO 

40 

AO 

Graphics option 

lf2 

if2 

42 

A2 

Ext. Comm. DMA 

i*3 

i*3 

43 

A3 

Comm/printer 7201 

if if 

if if 

44 

A4 

Ext. Comm, int 0 

h5 

^5 

45 

A5 

(or Winchester) 

Keyboard 

k6 

46 

46 

a6 

Int from Z80A 

^1 

47 

47 

A7 

Software 1 nterrupts 

50/60 hz timer 

6if 

64 

64 

64 

Direct diskette I/O 

65 

65 

65 

65 

F i rmware f unct i ons 

18 

18 

18 

18 

MS-DOS Interrupts 

program terminate 

20 

20 

20 

20 

function cal 1 

21 

21 

21 

21 

terminate address 

22/FO 

22/FO 

22/FO 

22/FO 

Control -Break exit address 

23 /Fl 

23/Fl 

23 /Fl 

23 /Fl 

fatal error address 

2if/F2 

24/F2 

24/F2 

24/F2 

absolute disk read 

25 

25 

25 

25 

absolute disk write 

26 

26 

26 

26 

terminate, stay resident 

27 

27 

27 

27 

Reserved by MS-DOS 

28 

1 

28 

28 

28 

1 


1 

3F 

1 

3F 

1 

3F 

1 

3F 
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The system module used in the Rainbow 100+ and 100B computers includes 
circuitry that permits the hardware interrupt types to be set to 
either of two values, 20H through 27H, or AOH through A7H. 

The firmware of the Rainbow 100+ and lOOB computers includes a user 
callable function that moves several interrupt vectors from one 
location to another. The MS-DOS Version 2.05 operating system selects 
the alternative hardware interrupts and moves their vectors so that no 
conflict between hardware and software generated interrupts exists. 

During system reset, the Rainbow computer's firmware initializes the 
interrupt vector for interrupt 28H (UO decimal) with the address of 
its built-in user callable functions. Interrupt 28H is also used by 
the operating system, however, so both MS-DOS Version 2.01 and Version 
2.05 move the vector for the firmware functions to interrupt 18H. 
Programs that invoke the firmware routines must use software interrupt 
18H. 


3 . 10.3 Modifying Interrupt Vectors 

Interrupt 21H, and MS-DOS system functions 25H and 35H, which set and 
get interrupt vectors for MS-DOS interrupts 20H through 27H, do not 
work for all of the interrupts. Applications which need to change 
these interrupt vectors should do so as follows: 

• MS-DOS Version 2.05 operating system running on Rainbow 100+ 
or lOOB computers 

Vectors for types 20H through 27H may be set and obtained by 
interrupt 21H, as well as by functions 25H and 35H. 

• MS-DOS Version 2.05 operating system running on the Rainbow 
100 

Vectors for types 22H, 23H, and 24H may be set or obtained by 
interrupt 21H, as well as by functions 25H and 35H. 

Vectors for the remaining types must be changed by placing the new 
address into specific memory locations. These must be in the usual 
double-word format. The memory locations are: 

Type # Memory Location 


(Hex) 

(Hex) 

20 

1*0:0294 

21 

1 * 0:0298 

25 

1*0:02A0 

26 

1*0:02A1* 

27 

1*0:02A8 


3-30 



MS-DOS 


• MS-DOS Version 2.01 operating system running on any Rainbow 
Series Computer 

Vectors for types 22H, 23H, and 24H may be set or obtained by 
interrupt 21H, as well as by functions 25H and 35H. 

Vectors for the remaining types must be changed by placing the new 
address into specific memory locations. These must be in the usual 
double-word format. The memory locations are: 

Type # 

(Hex) 

20 
21 

25 

26 
27 


Memory Location 
(Hex) 

L0:022B 

1*0:022F 

40:0233 

40:0237 

40:023B 
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MS-DOS VERSION 2.05 EXTENDED DOS FUNCTIONS 


4.1 INTRODUCTION 

This chapter describes special functions provided by the MS-DOS 
Version 2.05 BIOS. 

DOS System Function hkH - I OCTL calls most of these special features 
to permit device control operations. 

Chapter 2 describes some additional functions of the firmware. 


4.2 DEVICE DRIVERS 

The MS-DOS operating system requires a BIOS routine for each device on 
a system. These are called device drivers. ( The Mi crosof t MS-DOS 
Oper at i ng System Programmer * s Reference Manua 1 describes how these 
drivers routines are constructed, and the functions they provide.) 

There are two types of device drivers: 

• Serial I/O device drivers, 

• Disk drivers. 

The MS-DOS operating system calls serial devices "Character” devices 
and disk drivers "Block" drivers. The names reflect the amount of 
data handled during one call to the driver. One device driver can 
accommodate more than one actual device, as long as the devices are 
i dent i ca 1 . 
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When the MS-DOS operating system reads or writes data to a disk file, 
or sends a character to a port, it calls on the driver to perform the 
actual read or write operation. The file 10. SYS contains drivers. 
Each driver provides the following functions: 

• Initialization routines when you start the operating system 

• Media checking function (disk drivers only) 

• BIOS parameter block building (disk drivers only) 

• Optional lOCTL I/O control routines 

• Input and output routines 

• Status routines 

• Empty or "flush" routines 

The optional lOCTL function is usually provided because some device 
characteristics may need to be changed by an application. 

The MS-DOS operating system accesses these lOCTL functions through 
Function 44H. The MS-DOS Version 2.05 operating system has 
implemented several lOCTL functions for its serial I/O ports, 
diskettes, and Winchester hard disk. Some of the diskette and 
Winchester hard disk functions that would normally be accessed through 
Function 4i*H (lOCTL), have been implemented through software interrupt 
65H. 

Various functions provided for each device type in Version 2.05 are 
described below. 


it. 3 SERIAL I/O DEVICES 

Functions Invoked by Function - lOCTL 

DOS Function itltH invokes all 25 additional serial I/O functions. 

Most of these provide enhanced serial I/O port control and permit 
application programs to control these ports completely without the 
need for programming at the hardware level. 

To understand these Serial I/O functions, you should be familiar with 
the operation of the Mul ti -Protocol Serial Controller chip (Nec 7201 
or Intel 827^* MPSC) , because many of the terms and functions relate to 
it. 
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The Serial I/O functions operate with three ports: 

• Communication port (PORT A of the MPSC = AUX:) 

• Printer port (PORT B of the MPSC = PRN:) 

• Extended communications option port (PORT B of the option = 
AUX2) 

Notice that the ports are not identical, nor are all the functions 
appropriate for all ports. Certain baud rates and modem signals are 
not available for printer PORT A of the Extended Communications 
option. 


It. 4 FUNCTIONS NOT PROVIDED 

The following functions are not provided: 

Full modem-control protocols 
Synchronous protocols 

Extended communication option's PORT A (RS 422) 


4.4.1 PROTOCOLS 
Asynchronous Support 

Primitive routines are provided to support only asynchronous 
protoco 1 s . 

Limited Modem Control 

Limited Modem Control is provided so that application programs do 
not need to directly control the hardware. It also gives 
application programs a way to determine the state of the signals 
corresponding to each incoming and outgoing character. 
Characters received are assumed valid only when Receive Line 
Signal Detect (RLSD) is asserted, and the receive character is 
enabled. Characters are transmitted only when Clear To Send 
(CTS) is on. 

Data Leads Only 

Characters are transmitted and received regardless of the state 
of Data Terminal Ready (DTR) and Request To Send (RTS). 
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i+.4.2 RECEIVE AUTO XON/XOFF 

Auto XON/XOFF is supported at the driver level to handle receipt 
of XON/XOFF. If this feature is not selected, received XON/XOFF 
characters are stored as data in the circular buffer. 


i*.4.3 TRANSMIT AUTO XON/XOFF 

This option monitors the receive character buffer, and 
automatically transmits XON and XOFF characters when the number 
of characters in the buffer exceeds certain limits. For this 
option to be effective, the application program must supply a 
receive character buffer of adequate size. 


k.k.k ALTERNATE CONTROL CHARACTERS FOR XON/XOFF PROTOCOL 

The application program can specify control characters, other 
than DCl(llH) and DC3(13H), to be used for the XON/XOFF protocol. 


i+,4.5 MODEM SIGNAL CONTROL 

The application program can set or clear the modem control 
signals without accessing the hardware. 


k.k.e BREAK TRANSMISSION AND DETECTION 

Breaks can be sent for any duration, as determined by the 
application program. When a break is detected on a receiving 
device, a flag is set, which the application program can use as 
requ i red . 


k.h.7 PROGRAMMING OF PORTS 

Ports can easily be programmed without directly accessing the 
hardware. The management of the interdependencies of ports is 
also provided, thereby relieving the application program of this 
difficult task. Application programs pass control and other 
information to the routines by a Communication Control Block 
(CCB) , as described below. 
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h.k.8 RECEIVE CHARACTER AND TRANSMIT BUFFER EMPTY INTERRUPTS 

Functions are provided that install and pass control to an 
application's interrupt handler upon: 

• Receipt of a character 

• Detecting that the transmitter buffer is empty 

You can program the MPSC to generate interrupts under these two 
conditions. Any such interrupt handlers must also be disabled by 
the application program before termination. Functions are also 
provided to do this. 


4. A. 9 APPLICATION SUPPLIED BUFFER SIZE AND SPACE 

An application can specify its own buffer size and location to be 
used for received characters. Each received character occupies 
two bytes in the buffer. One byte contains the character, the 
other byte contains information about the status of the port at 
the time the character was received (buffer overrun, parity 
error, break detection). 

Applications should specify a buffer of at least 512 bytes if 
they use the auto transmit XON/XOFF feature. Such applications 
must be careful to restore the regular buffer before termination. 
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lt.lt. 10 COMMUNICATION CONTROL BLOCK 

MPSC control and setup information is passed between application 
programs and the functions through a Communication Control Block 
(CCB) . Each cell of the CCB is a byte, except for the address 
and length of the optional user-specified buffer. 

Notice that not all possible values are appropriate for all three 
ports, nor are all combinations of supported features allowed 
(for example, only Mark and Space are provided for 7 bits 
characters, and some values are included only for future support 
(for example, 7200 baud rate) . 

It is necessary to create or modify a CCB whenever a different 
configuration is required for a port. Each field of the CCB must 
be filled with the appropriate code for the desired parameter. 
Only those parameters that need to be changed must be filled. 
Those to remain unchanged must contain zero. When a passed value 
is not appropriate, the high order bit of the byte or word 
parameter is set to indicate an error. 

NOTE 

Though some validity checking on passed 
parameters is performed, it is not guaranteed. 

The application program must insure that the 
rules and interfaces specified below are 
carefully followed. 
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Table 4-1: Communications Control Block Format 


Offset Offset Contents Possible values 

(Hex) 

0 Device number 1 “communications, 2=pr inter, 

3=ex tended comm 

1 Modem Control l=data only, 2=limited modem control 

2 Stop bits l=one, 2*one and one half, 3=two 

3 Data bits ** 5. 6. 7. 8, JS, 7M 

4 Parity ** Even, Odd, None 

5 Receive baud 17 values ( no 7200 baud ) 

[printer cannot split baud rates ] 

6 Transmit baud 17 values (no 7200 baud) 

7 XON character If alt XON character to be used 

8 XOFF character If alt XOFF character to be used 

9 RCV XON/XOFF On or Off 

A XMT XON/XOFF On or Off 

B Alternate If auto XMT XON/XOFF selected, user 

I buffer size receive buffer is strongly suggested. 

C An error is returned if the user buffer 

size is less than default. 

D start address This field must have entry if user 

I of buffer in buffer size is non-zero. 

E offset, segment 

I format. 

F 

1 

10 


** Data bits and parity should be specified together. In all fields 
of the CCB, zero means no change is requested 

If an alternate receive buffer is selected, a non-zero value 
greater than 50H must be entered. Otherwise the start address for 
the buffer is ignored and the default buffer is used. 
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Table 4-2: Communications Control Block Parameter Values 


Device Number: 

1 2 3 

Parameter Values: (AUX) (PRN) (AUX2) 

Default Values: 

Modem Control: 

0 = No Change 

1 = Data Leads 1 1 1 

2 = Limited Modem Control 

Auto XON/XOFF: 

0 = No Change 

1 = On 

2 = Off 

Stop Bits: 

0 = No Change 

1 = One 

2 = one and one-half 

3 = two (stop bits) 

Data Bits: 

0 = No Change Data bits and Parity 

1 = 5 should be specified 

2=6 together (see note) . 

3 = 7 

4 = 8 

5 = 7+Space 

6 = 7+Mark 

Parity: 

0 = No change Data bits and Parity 

1 = even should be specified 

2 = odd together (see note) . 


3 = none 

3 

3 

3 

Note: If parity is specified without 

data bi ts 

also 

being specified 

for a new configuration, an 

error might be 

returned if the 

parity specified is odd or even 
effect were 7M or 7S. 

and the 

data bi 

ts previously in 

XON character: 

1 IH 

1 IH 

1 IH 

XOFF character: 

13H 

13H 

13H 

Baud Rate - RCV (See table for values) 

lOH 

OEH 

lOH 

- XMT 

lOH 

OEM 

lOH 

Buffer Size: (l6-blt words) 

50H 

50H 

50H 
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RCV: 222 
XMT: 2 2 2 





Table l»- 3 : 

MS-DOS VERS 
Baud Rates 

ION 2.05 

EXTENDED DOS FUNCTIONS 

50 

< Hex Value 

Comm. Ext 

1 

placed i 
. Comm . 

1 

in CCB > 

Printer (*) 

75 

2 

2 

2 

1 10 

3 

3 

- 

13^».5 

4 

4 

- 

150 

5 

5 

5 

200 

6 

6 

- 

300 

7 

7 

7 

600 

8 

8 

8 

1200 

9 

9 

9 

1800 

A 

A 

- 

2000 

B 

B 

- 

21*00 

C 

C 

c 

3600 

D 

D 

- 

4800 

E 

E 

E D 

7200 



s't* 

9600 

10 D 

10 D 

10 

19200 

1 1 

1 1 

- 


D Default Setting 


* Transmit and Receive Baud rates for the printer port must always 
be the same. 

Vo’c 7200 Baud is not available for any port. 

Not ava i 1 ab 1 e 


i +.5 CALLING PROCESS 

Application programs access functions by means of MS-DOS system 
function 44 H (lOCTL). Entry conditions follow: 

NOTE 

If the port number specified is invalid, the function 
might be ignored or an error condition might be 
returned. Application programs must determine whether 
a device is installed. This can be done by invoking 
the “Read Device Setup" function 
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FUNCTION l»ltH - I/O CONTROL FOR DEVICES 
ENTRY 


AH » kkH 

AL = Function code 

Both 02H and 03H work for either READ or WRITE 

BX * Handle number 
03H = AUX 
04H = PRN 

(AUX2 must be "Opened" via MS-DOS to get handle number) 

DS;DX = lOCTL Packet Address 
EXIT 

Returned Data in lOCTL packet 
The format of the lOCTL packet is: 

Offset Label Description 

0 Function Sub-function Number 

1 Func_retC Function return code: 

FFH = successful, 0 = unsuccessful 

2 Character Character Input or Output 

3 Char_Stat Character Status 

A to n Buffer Block Buffer 

The application program must supply the device number in the 
applicable buffer field. Set-up parameters must be passed each time a 
different set-up is required. The entry to each parameter either 
contains zero, if the parameter is to remain unchanged, or a value 
from 1 to the largest applicable number for that parameter. On return 
to the caller, the high order bit of the appropriate byte is set, if 
the particular option requested is not supported. However, this is 
not guaranteed if a value is outside of the range specified. 

MODEM SIGNALS - Modem signals that are available are listed below. 
Notice that unused bits are undefined. See Functions 13 and lA below 
for full description of their use. 
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Incoming signals. 


Bit 

+ + + + + + + + + 

I 7 I 6 I 5 1 M 3 I 2 I 1 I 0 1 

-+ 





1 

+ 

1 

1 

1 

+ 

1 

1 

1 

+ 

1 

1 

1 

•--+ 

1 

1 

1 

1 

1 

till 

i i i 1 

1 Ri 

1 

1 

1 

1 

1 

1 

1 

1 1 1 1 

till 

1 i 1 

SRLSD 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 1 1 

1 1 
1 1 


1 

1 

1 

1 

1 

1 

1 

1 

1 

1 I 

1 1 CTS 

1 


1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

|RLSD 



speed indicator) 


NOTE 

SRLSD and SPDI signals are assigned to the same 
physical line. It i s up to the application program to 
determine which one is connected. The remainder of 
the specification refers to this physical line as the 
signal SRLSD. 

Also, control signals sometimes use connector pins 
other than those shown so that they can be monitored. 
The signals named in this document refer to the 
corresponding pin-outs and not the specific signals. 

Outgoing signals that can be asserted. 

Bi ts 

H 1 1 i H 1 1 H H 

I 7 I 6 I 5 1 M 3 I 2 I 1 1 0 I 

+ — + — + — + — + — + — + — + — + 

I I I I I I I 1 SP (speed select) 

I I I i I I I 

I I I I I I I SRTS 

I I I I I I 

I I I I I I dtr 

I I I I I 

I I I I 1 RTS 
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It. 6 LOGICAL ASSIGNMENT OF DEVICES, AND DEFAULT SETTINGS 
The two ports on the motherboard are assigned as follows: 

PORT A to AUX 
PORT B to PRN 

j 

PORT B on the extended communications option is assigned to AUX2 

If the port (device) number is invalid, the function might be ignored 
or return an error condition. 

It is up to the application program to determine if the device is 
installed. Do this by invoking the "Read Device Setup Values" 
function. 

FUNCTION 0 - PROGRAM DEVICE 

This function reprograms the indicated device to the values specified 
in the CCB. It has no effect on the state of receiver enable. 

ENTRY 


(FUNCTION) = 0 
(BUFFER) = CCB 

EXIT 

(FUNC_RETC) = FFH, all functions programmed successfully 

= 0 not all functions programmed successfully. The 
fields that cannot be programmed in the control 
block are marked with high order bit set. 

NOTE 

RCV interrupts MUST be disabled before invoking this 
function, if the start address of the User's Buffer is 
changed by this function. Use Function 5 to do this. 
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FUNCTION 1 - PROGRAM DEVICE TO DEFAULT NVM SETTINGS 

This function reprograms the device to the default values specified in 
NVM. The optional communications port is set to the same values as 
the comm port. The receiver is enabled. 

ENTRY 

(FUNCTION) = 1 

EXIT 

None 


NOTE 

RCV interrupts MUST be disabled before invoking this 
function, if the start address of the User's Buffer is 
changed by this function. Use Function 5 to do this. 


FUNCTION 2 - SET DEVICE TO USE DEFAULT BUFFER 

This function reprograms the device to use the default buffer. This 
must be done before program termination. The default buffer is 
reinitialized before it is used again. 

ENTRY 

(FUNCTION) = 2 

EXIT 

None 


NOTE 

Interrupts MUST be disabled before invoking this 
function, if the start address of the User's Buffer is 
changed by this function. 
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FUNCTION 3 - read DEVICE SET-UP VALUES 

This function returns, in the CCB, information on the state of the 
device, that is, how it is programmed. The application must fill in 
the device number prior to the call to indicate which device is being 
asked for. All other fields must be set to zero. 

ENTRY 


(FUNCTION) = 3 
(BUFFER) = CCB data 

EXIT 


(FUNC_RETC) = 0, illegal device number, or device not installed. 
= FFH, operation successful 

(BUFFER) = Current Device Settings 


FUNCTION h - ENABLE RECEIVER INTERRUPTS 

This function enables the MPSC to receive characters. Characters 
received are placed in a circular buffer. In case of overruns, lAH is 
stored in the buffer. Each character is stored along with its status. 
Receiver- i nterrupts are normally enabled. 

ENTRY 


(FUNCTION) = A 

EXIT 

None 

NOTE 

The function is ignored if the device number is 
inval id. 
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FUNCTION 5 - DISABLE RECEIVER INTERRUPTS 


This function ignores received characters. 
ENTRY 

(FUNCTION) - 5 

EXIT 

None 


FUNCTION 6 - READ INPUT DEVICE STATUS 

This function reads the status of the device's receive buffer. 
ENTRY 

(FUNCTION) = 6 
EXIT 

(FUNC_RETC) = FF, character available 
= 0 , char not available 


FUNCTION 7 - READ INPUT CHARACTER, RETURN IF NONE AVAILABLE 

This function reads the next character from the circular buffer, 
none are available, return to the caller. 


ENTRY 


(FUNCTION) = 7 
EXIT 


(FUNC_RETC) = FF, character available 
= 0, char not available 


(CHARACTER) 


character, if available. 


(CHAR_STAT) 


character status 


Bit 7 
Bit 6 
Bit 5 
Bit It 


1 Break character 
1 Framing Error 
1 Overrun error 
1 Parity error 
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FUNCTION 8 - GET CHARACTER, RETURN WHEN AVAILABLE 

This function reads the next character from the circular buffer. If 
none are available, wait till one is available. 

ENTRY 

(FUNCTION) = 8 
EXIT 

(CHARACTER) = character 

(CHAR_STAT) = status of character 

Bit 7 = 1 Break character 
Bit 6 = 1 Framing error 
Bit 5 = 1 Overrun error 
B i t 4 = 1 Par i ty error 


NOTE 

The function is ignored if the device number is 
i nva lid. 


FUNCTION 9 - read OUTPUT DEVICE STATUS 

This function reads the status of the transmitter. 

ENTRY 

(FUNCTION) = 9 
EXIT 

(FUNC_RETC) = FF transmitter ready 

= 0 transmitter not ready or device number invalid 

NOTE 

If auto XON/XOFF is active, the state of the output 
status can change between 2 function calls. 
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FUNCTION 10 - WRITE CHARACTER, RETURN IF UNABLE TO 

This function puts the character in the transmitter. If it is 
unsuccessful, return to caller with appropriate error. 

ENTRY 

(FUNCTION) = 10 
(CHARACTER) = character 
EXIT 

(FUNC_RETC) = FFH transmit successful 

= 0 unable to transmit or device number invalid 

NOTE 

If auto XON/XOFF is enabled, the drivers monitor and 
handle XON and XOFF characters. 

FUNCTION 11 - PUT CHARACTER, RETURN WHEN SUCCESSFUL 

This function puts a character into the transmit buffer, and does not 
return until the character is accepted. 

ENTRY 

(FUNCTION) = 1 1 
(CHARACTER) = character 
EXIT 
None 


NOTE 

This function is ignored if the device number is 
i nval i d . 

If auto XON/XOFF is enabled, the drivers monitor and 
handle XON and XOFF characters. 
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FUNCTION 12 - TRANSMIT CHARACTER IMMEDIATELY 

This function puts a character into the transmit buffer immediately, 
ahead of other characters in the queue, if any. It ignores the state 
of the modem signals, that is, if limited modem control is used, it is 
ineffective for this character, and the characters ahead of it in the 
buffer. USE THIS FUNCTION ONLY IN EMERGENCY SITUATIONS. 

ENTRY 


(FUNCTION) = 12 
(CHARACTER) = character 
EXIT 
None 


NOTE 

This function is ignored if the device number is 
i nva lid. 

If auto XON/XOFF is enabled, the drivers monitor and 
handle XON and XOFF characters. 

FUNCTION 13 - READ MODEM SIGNALS 

This function fetches the incoming modem signals and the state of the 
transmit/receive flags. (Not applicable to the Printer port.) 

ENTRY 

(FUNCTION) = 13 
EXIT 

(CHARACTER) = 


Bit 

7 

= 1. 

modem 

signals cannot 

be read 

Bi t (s) 

5-6 

, Undefined 


Bit 

k 

= 1. 

RLSD 

(comm port pin 

8) 

Bit 

3 

= 1, 

CTS 

(comm port pin 

5) 

Bit 

2 

= 1. 

DSR 

(comm port pin 

6) 

Bit 

1 

= 1. 

SRLSD 

(comm port pin 

12) 




or 






SPDI , 

bell 212A speed indicator 

Bit 

0 

= 1, 

Rl on 

(comm port pin 

22) 
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(CHAR_STAT) = 

Bit 7 = U XOFF transmitted 
Bit 6 = 1, XOFF received 
Bit 5=1* Receiver disabled 
Bit(s) 1-4, Undefined 
Bit 0 = 1, Transmitter empty 


FUNCTION 14 - SET/RESET MODEM OUTPUT SIGNALS 

This function changes the state of the outgoing modem signals to the 
desired mask value. Notice that this also clears unmasked signals. 
The printer port's MODEM signals cannot be set. Modem signals are 
positive when asserted. 

ENTRY 


(FUNCTION) = 14 

(CHARACTER) = Modem signal mask 


B i t (s) 4-7 . I gnored 


Bit 

3 = 

1 , 

RTS 

set 

(connector 

pin 

4) 

Bit 

2 = 

1. 

DTR 

set 

(connector 

pi n 

20) 

Bit 

1 = 

1, 

SRTS 

set 

(connector 

pin 

19) 

Bit 

0 = 

1, 

SP set 

(connector 

pi n 

23) 


EXIT 

(FUNC_RETC) = 0 modem signals cannot be set 
= FF modem signals set 


FUNCTION 15 - TRANSMIT BREAK 

This function latches the transmi t-data line to a space condition 
until "cease transmission of break" is requested. Invoke a CEASE 
TRANSMISSION OF BREAK function after the desired BREAK time has 
elapsed . 

ENTRY 


(FUNCTION) = 15 

EXIT 

None 
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NOTE 


It is up to the application program to insure (if 
appropriate) the transmitter is empty. 


Notice also that the duration of the space condition 
is completely up to the application program. 


FUNCTION 16 - CEASE TRANSMISSION OF BREAK 

This function returns the transmi t-data line to a marking condition to 
terminate a previous “transmit break" command. 

ENTRY 

(FUNCTION) = 16 

EXIT 

None 


FUNCTION 17 “ SET RECEIVE CHARACTER INTERRUPT 

This function permits a user's subroutine to be called upon each 
received-character interrupt. The call is made with a far call, and 
the user's routine must exit with a far return. The routine is called 
after the interrupt is serviced and has been reenabled. If a second 
interrupt occurs before this routine has been completed, it is not 
called the second time. 

When called, the routine has the following conditions: 

1. Interrupts off, and should remain off. 

2. Stack is already changed to communications stack. 

3. All register should be preserved by the called routine. 
Allow enough stack space for this. 
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The routine should not call any DOS functions. 

ENTRY 

(FUNCTION) = 17 

(BUFFER) = 5“byte buffer: 

Byte 0 = device number 

Bytes 1-4 = offset and segment of routine to be called 


EXIT 

(FUNC_RETC) = 0 device invalid or not installed 
= FF successful 


FUNCTION 18 - CANCEL RECEIVE CHARACTER INTERRUPT 
This function cancels any previous function 17 calls. 
ENTRY 

(FUNCTION) = 18 

EXIT 

None 


FUNCTION 19 ~ TRANSMIT BUFFER BECOMING EMPTY INTERRUPT 

This function permits a user’s subroutine to be called upon 
transm i t-buf f er-empty interrupt. The call is made with a far 
and the user's routine must exit with a far return. The routi 
called after the interrupt is serviced and reenabled. If a 

interrupt should occur before the routine has finished, it i 
called the second time. 

All registers should be preserved by the called routine, so 
enough stack space for this. 


each 
call, 
ne i s 
second 
s not 


allow 
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The routine should not call any DOS functions. 

ENTRY 

(FUNCTION) = 19 

(BUFFER) * 5-byte buffer: 

Byte 0 = device number 

Bytes ]-k = offset and segment routine to be called 


EXIT 

(FUNC_RETC) = 0 device invalid or not installed 
= FF successful 

FUNCTION 20 - CANCEL TRANSMIT BUFFER BECOMING EMPTY INTERRUPT 
This function cancels any previous Function 19 calls. 

ENTRY 

(FUNCTION) = 20 

EXIT 

None 


FUNCTION 21 - SET USER DEFINED INTERRUPT SERVICE ROUTINE 

This function redefines the interrupt service routine for a given 
device. When an interrupt occurs for the device, the application 
service routine is called instead of the normally defined interrupt 
service routine. Use this function only under unusual circumstances, 
such as for asynchronous protocols, and then only if you are familiar 
with the operation and programming requirements of the MPSC. 

Register AX on entry to the call contains twice the value of MPSC 
register 2B. The latter contains one of eight vector values according 
to the source of the interrupt. 

All registers should be preserved by the called routine. Allow enough 
stack space for this. 

The routine should not call any DOS functions. 
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Also, the installed driver sends an EOl instruction to the MPSC so the 
called routine need not send this instruction. 

ENTRY 


BX = (Contents of MPSC Register 2B) * 2 

(FUNCTION) = 21 

(BUFFER) = 5-byte buffer: 

Byte 0 = Device number 

Bytes 1-4 = Offset and segment of routine to be called 


EXIT 

None 


FUNCTION 22 - RESET DEVICE INTERRUPT VECTORS 

This function resets the interrupt service routine back to the 
system-defined service routine. 

ENTRY 

(FUNCTION) = 22 

EXIT 

None 


FUNCTION 23 - SET EXTERNAL STATUS CHANGE INTERRUPT 

This function permits a user's subroutine to be called upon each 
external -status-change interrupt. The call is made with a far call, 
and the user's routine must exit with a far return. 

ENTRY 


(FUNCTION) = 23 

(BUFFER) = 5-byte buffer: 

Byte 0 = device number 

Bytes 1-4 = Offset and segment of routine to be called 


EXIT 

(FUNC_RETC) = 0 Device Illegal or not installed 
= FF successfully canceled. 
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FUNCTION 2h - CANCEL EXTERNAL STATUS CHANGE INTERRUPT 
This function cancels any previous function 23 call. 
ENTRY 

(FUNCTION) = 2k 

EXIT 

None 


FUNCTION 25 - NON-DESTRUCTIVE CHARACTER READ. NO WAIT 


This function returns the next ava 
ring-buffer, if any, but does 
ring-buffer. This function allows 
input character. 


lable character in the device's 
not remove the character from the 
the application to look ahead one 


ENTRY 


(FUNCTION) = 25 
EXIT 

(FUNC_RETC) = FF if a char is available 
=0 if no char is available 


(CHARACTER) = character, if available 


k.J DISK CONTROL FUNCTIONS 

All diskette lOCTL-type functions are invoked using INT 65 H. This is 
instead of the usual MS-DOS lOCTL function I 44 H with INT 21H, because 
using function 4LH would cause drive motor problems. The functions 
are called differently under MS-DOS Version 2.01 and Version 2.05. 
Both calling processes are described below to emphasize their 
d i f f erences . 

The Winchester disk lOCTL functions are called by the MS-DOS lOCTL 
function L4H using INT 21H. They can be invoked only with Version 
2 . 05 , since Version 2.01 does not support Winchester drives. Since 
Winchester media are not removable, the media check function need not 
be enabled or disabled, so functions 6-8 are not defined for the 
Wi nchester . 
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4.8 VERSION 2.01 DISKETTE FUNCTIONS 
ENTRY 


DS:BX = Pointer to control block: 
Control Block Format 
Offset 


0 

CTLBLK 

DB 

Function code: 

0 Write 

1 Read 

2 Media check 

1 


DB 

Drive code (0=A, 1=B, 2=C, 3=D) 

2 

TRACK 

DB 

Track number (first is 0) 

3 


DB 

Sector number (first is 1) 

4 


DB 

Sector count (must be 1) 

5 

CURTRK 

DB 

Current track (OFFH initially) 

6 


DB 

Format (must be 0, RX50 media only) 

7-B 


DB 

o 

o 

o 

o 

o 

C-D 


DW 

Offset of user buffer for one ful 1 sector 
(512 bytes) 

E-F 


DW 

Segment of user buffer (Buffer must all be 


shared memory ( OO 8 OOH to OFFFFH.) 

EXIT 

Carry NOT SET: 

AL = 0 Function successful 

Carry SET: 

AL = 0 Write protected 

2 Not ready, or busy 
4 CRC error 

6 Seek error 

7 Rob i n med i a 

10 Write fault 

1 1 Lost data 

EXAMPLE 


MOV BX, offset CTLBLK 
I NT 65 H ; saves only DS and ES 

MOV AH.OFFH ;in case of error, 

; track is unknown 

JC SETCURT 

MOV AH, TRACK ;otherwise, track is as requested 
SETCURT: MOV CURTRK,AH ;set correctly before next call 
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it. 9 VERSION 2.05 DISKETTE FUNCTIONS 
ENTRY 


DS:BX = Pointer to control block DIFFERENT from 2.01: 

Control Block Format 
Offset 

0 FCTLBL DB Function code: 

0 Read 

1 Write 

2 Wr i te wi th ver i f y 

3 Format track 
it Media check 

5 Verify disk 

6 Enable media check function 

7 Disable media check function 

8 Status of media check function 

1 DB Drive code (0=A, 1=B, 2=C, 3=0 » 

0FFH=physical unit) 

2 DB Sector # (one-based, skewed if track > 1) 

3 DB Physical unit ( only if drive code = OFFH) 

High nibble = unit number 

(0 to 3 for diskettes A to D) 

Low nibble head number 
(normally 0, for first side) 
it-5 DW Track number (first is 0) 

6-7 DW Sector count (always 1, ignored) 

8-9 DW Offset of user buffer (512 bytes) 

A-B DW Segment of user buffer (Buffer may be anywhere in 

memory, except "format track" must be in absolute 
00800H-OFFFFH.) 

EXIT 

Carry NOT SET: 

For functions 0 - 5s 

AL = 0 Function successful 

For functions 6-8: 

AL = 0 Media check function enabled 
1 Media check function disabled 
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Carry SET (functions 0-5 only); 
AL = 0 Write protected 

2 Not ready, or busy 
h CRC error 

6 Seek error 

7 Robin media 

10 Write fault 

1 1 Lost data 

EXAMPLE 


MOV BX, offset FCTLBL 

1 NT 65 H ;Functions 0-5 save BX, DS, ES 

;Functions 6-8 save all except AX 


A. 10 VERSION 2.05 WINCHESTER 
ENTRY 


AH = 1*1*H 

AL = Function code (must be k or 5) 

BL = Drive (0=default, 5=E, 6=F , 7=G, 8=H) 

DS;DX = Pointer to control block DIFFERENT from diskette 

Control Block Format 

Offset 

0 DB Function code: 

0 Read 

1 Write 

2 Wr i te wi th ver i f y 

3 Format track 
k Media check 

5 Verify disk (simply returns AL=5) 

1 DB Drive code 

(4=E, 5=F» 6=G, 7=H, 0FFH=phys ical unit) 

Notice difference from drive value in BL 

2 DB Sector number 

(first is 1, skewed if track > 1) 

3 DB Physical unit ( only if drive code = OFFH) 

High nibble = unit 

(0, has only one physical unit) 

Low nibble = head or surface 
(0 to 3> unit has h heads) 

Notice that track = cylinder and is not offset, and 
that sector is not skewed, when performing physical 
unit 1/0. 
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Offset 

k~S DW Track number 

(first is 0, offset from partition start) 

6-7 OW Count of sectors (functions 0-2) 
or tracks (function 3) 

8-9 DW Offset of user buffer for either: 

sector data (512 bytes each for read or write), or 
track data (for formatting, 32 bytes per track, 2 
each for I 6 sectors, first is OOH for normal or 8 OH 
for bad, second is logical sector number to write) 

A-B DW Segment of user buffer (may be anywhere in memory) 

C DB Returned status from driver 

D DB Error type bits (= AH, valid if status is 1, 3» or ODH) 

EXIT 

AL = Returned status: 

00 Function successful 

01 Error (during read, write, or format) 

03 Write fault at drive (or 8-second timeout) 

05 Invalid drive in BL or in WCTLBL 
ODH Write verify error (during reread after write) 

OFH Soft read error (retries were done and worked) 

OFFH Driver not called (only way to tell) 

AH = Error type bits (for functions 0-3 only): 

01H Data Address Mark not found (during read) 

02H Track 0 error (cannot restore to track 0) 

OAH Aborted (new command issued while busy) 
lOH ID not found (or track number too large) 

1*0H CRC error in data field (after 8 retries) 

80H Bad block detect (sector is marked as bad) 

EXAMPLE 


MOV AX,i|l*0l»H ;I0CTL function for disk 

MOV BL,5 ;for drive E, first Winchester partition 

MOV DX, offset WCTLBL 

INT 21H ;saves DS, ES, SI , Dl , BP 
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MS-DOS PROGRAMMING NOTES 


5.1 DIRECT ROM CALLS 

5 . 1.1 IBM ROM Calls (INT 10) 

• Set mode 

• Set cursor type 

• Set cursor position 

• Read cursor position 

• Select active display page 

• Scroll active page up 

• Scroll active page down 

• Read attribute and character at current cursor position 

• Write attribute and character at current cursor position 

• Write character at current position 

5 . 1.2 Rainbow ROM Calls (INT 18H under the MS-DOS operating system) 

• Write character at current position 

• Disable/enable cursor o Send data to screen 
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5.1.3 Set Mode 


I BM computer 


40 x 25 black _white 
80x25 black _white 

RAINBOW computer 


ANSI Escape Sequences 

ESC #5 - 80 X 24 

ESC #6 - 40 X 24 


5.1.4 Set/Read Cursor position 
RAINBOW computer 


ANSI Escape Sequences 

ESC[#;#H Set Cursor position 

ESC[#;#R Read Cursor position 

The # refers to a numeric value. 


5.1.5 Paging 

RAINBOW computer 


The Rainbow computer does not support a paging scheme for the 
video. If paging is required, you must write your own support 
rout i ne (s) . 
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5.1.6 Read Attribute and Character 
RAINBOW computer 


The Rainbow computer does not support reading attribute and 
character. You can write a routine to read the cursor position, 
calculate the memory location, then return the character and 
attribute set. 


5 . 1.7 Write Character at the Current Cursor Position 


IBM Ra i nbow 

Computer Computer 


Funct i on 

0 

II 

<c 

Dl = 0 

Character 

AL 

AL 

Page 

BH 

N/A 

# Repeat Char 

CX 

N/A 


5.1.8 Write Character and Attribute 


RAINBOW computer 


A single system call can write multiple characters/attributes 
(see below) . 

Rainbow Fast Access to Video Memory by ROM (I NT 18H) 

01 = lit 

AX = Transfer type 

0 “Character _Attribute 

1 = Attribute only 

2 = Character only 
BL = Line number (I- 2 I 4 ) 

BH = Column number (1-132) 

CX = Number of Char/Attr to transfer 
DX = Start address of Attributes 
SI = Start address of Characters 
BP = Segment code 
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Table 5“ Is Memory Map for Video 


IBM computer 


BOOOO to B3FFF 16K Character/Attribute RAM 

Even bytes are Character RAM 
Odd bytes are Attribute RAM 

RAINBOW computer 


EEOOO to EEFFF AK Character RAM 
EFOOO to EFFFF 4K Attribute RAM 


Rainbow Video Memory Map - RAM Addresses 

Direct video memory access routines start by issuing escape sequence 
ESC[?31 with a generic I NT 21H call. After receiving this escape 
sequence, the video memory appears as follows for an 80 column 
di splay: 

(The addresses are for the first line of the display.) 

EE00:12 - EE00:6l (80 characters) 

:62 Termination Char (FF) 

:63“6A Address of next line 

Subsequent line addresses are listed below: 

LINE 2 99H 

LINE 3 120H 

LINE k 1A7H 
LINE 5 22EH 
LINE 6 2B5H 
LINE 7 33CH 
LINE 8 3C3H 
LINE 9 ^^AH 
LINE 10 ADIH 
LINE 11 558H 

LINE 12 5DFH 
LINE 13 666H 

LINE 1L 6EDH 
LINE 15 77^H 


5-h 





MS-DOS PROGRAMMING NOTES 


LINE 

16 

7FBH 

LINE 

17 

882H 

LINE 

18 

909H 

LINE 

19 

990H 

LINE 

20 

A17H 

LINE 

21 

A9EH 

LINE 

22 

B25H 

LINE 

23 

BACH 

LINE 

2k 

C33H 

LINE 

25 

CBAH 


(Used when Scrolling) 


Table 5~2: Character Attributes 



IBM 

Computer 

RAINBOW 

Computer 

REVERSE VIDEO 

YES 

YES 

BLINK 

YES 

YES 

UNDERSCORE 

YES 

YES 

BOLD 

YES 

YES 


Table 5-3: 

IBM Attribute Byte Bi 

i t Mask 

7 

65 ^ 

3 

2 1 0 

B1 ink 

r g b 

1 ntens i ty 

r g b 


Foreground 


Background 

Background Foreground 

Funct i on 

r g 

b r 

g b 


0 0 

0 0 

0 0 

Non display 

0 0 

0 0 

0 1 

Under 1 i ne 

0 0 

0 1 

1 1 

Wh i te character 

1 1 

1 0 

0 0 

Reverse video 
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Table 5“^! Rainbow Attribute Byte Bit Mask 


Bi t 3 * Underscore 

0 = Underscore 

1 * No underscore 

Bit 2 “ Blink 

0 = Blink 

1 = No bl ink 

Bi t 1 = Bold 

0 = Bold 

1 = No bold 

Bit 0 = Reverse Video 

0 = Normal 

1 = Reverse video 


5.2 KEYBOARD INTERFACE (IBM COMPUTER) 
5.2.1 Generic MS-DOS calls (INT 21H) 


• Function 1 (Read Keyboard and Echo) 

• Function 6 (Direct Keyboard I/O) 

• Function 7 (Direct Keyboard Input) 

• Function 8 (Read Keyboard) 

• Function 10 (Buffer Keyboard Input) 

• Function 11 (Check Keyboard Input) 

• Function 12 (Flush Buffer, Read Keyboard) 

NOTE 

These generic calls work the same in both IBM and 
Rainbow systems 
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5.3 DIRECT ROM CALLS 
5.3.1 IBM ROM Calls (I NT I6) 


• Keyboard Input (AH= 0 , character returned in AL) 

• Keyboard Status (AH= 1 , Z-flag set = no character, character 
in AX) (Notice that this allows non-destructive read.) 

• Return the current shift status 


5.3.2 Rainbow ROM Calls (INT 40 ) 

• Keyboard Input (Dl= 2 , character returned in AL) 

• Keyboard Status (Dl= 4 , CL =0 no char / CL=FFH, AL=char) 

• Level 1 Keyboard Input ("raw" key-code) 


5.4 IBM SHIFT KEY STATUS 

The Shift status is the second charter of a keyboard. Function keys 
and other keys generate two-byte inputs. 

The Rainbow computer generates an escape sequence when you type 
special keys (for example, keypad) and function keys. These escape 
sequences must then be parsed by the application. 


5.5 DISK INTERFACE 
5.5.1 Generic MS-DOS Calls 

All generic disk calls are equivalent in the two systems. 
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5.6 DIRECT HARDWARE/FIRMWARE/BIOS CALLS 
5.6.1 IBM ROM Calls (INT I3) 

• Reset disk system 

• Read status 

• Read disk sector 

• Write disk sector 

• Verify disk sector 

• Format di sk 


5.6.2 Rainbow Floppy Diskette Calls (INT 65) 
(lOCTL AA) 

See Chapter Four for details. 



Read sector 



Write sector 



Wr i te and ver 

ify 


Format 



Media check 



Ver i f y med 1 a 

(bad 


and Winchester Calls 


5.7 SAMPLE PROGRAM 

The following sample program shows the use of MS-DOS system function 
ABH (EXEC). "Shelling" (a term used by the UNIX and XENIX operating 
systems) means to invoke the operating system's command processor to 
load and start a program. The MS-DOS system function AB is called 
"EXEC". The sample program is written for assembly by Microsoft's 
MASM. 


TITLE: Exec cal 1 test 
PAGE: 60,132 
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Notice that no stack segment is defined. This is because the program 
is linked as a .COM file that, when loaded, has all segment registers 
set to the same value. Notice that the program is ORGed at lOOH. 
This is necessary for 

code SEGMENT 'codesg' 

ASSUME CS:code,DS:code,ES:code 

ORG OlOOH ; Program entry point 

exectest: ; 


MOV 

SP, OFFSET stack 

9 

Set up local stack 

MOV 

AH,09H 

9 

Print "Before shel 1" 

MOV 

DX, OFFSET messl 

9 


INT 

21H 

9 


MOV 

BX, OFFSET lastloc +15 

9 

BX := program size in 

MOV 

CX,4 

9 

paragraphs 

SHR 

BX,CL 

9 


MOV 

AX,l*AOOH 

9 

Deallocate unused memory 

INT 

21H 

9 


MOV 

SI ,2CH 

» 

Get environment address 

MOV 

AX,CS: [SI] 

1 

from PSP+2CH 

MOV 

WORD PTR parmblk,AX 

> 


MOV 

AX,CS 

*9 

Set segment registers 

MOV 

WORD PTR parmA,AX 

9 

in parameter block 

MOV 

WORD PTR parm 8 ,AX 

9 


MOV 

WORD PTR parmC,AX 

9 


MOV 

DX, OFFSET filenam 

9 

Set up exec cal 1 

MOV 

BX, OFFSET parmblk 

9 


MOV 

AX,4BOOH 

9 


PUSH 

DS 

9 

Save machine state 

PUSH 

ES 

5 


MOV 

CS:savess,SS 

♦ 


MOV 

CS : savesp, SP 

9 


INT 

21H 

9 

Shel 1 to DOS 

MOV 

SP , CS : savesp 

9 

Restore machine state 

MOV 

SS , CS : savess 

9 


POP 

ES 

9 


POP 

DS 

9 
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MOV 

AH.09H 


Pr i nt "After shel 1 " 


MOV 

DX, OFFSET mess2 j 



INT 

21H 




INT 

20H 


Terminate program 

savess 

DW 

7 


Holders for SS:SP 

savesp 

DW 

7 



messi 

DB 

' Before 

shel 1 ' .ODH.OAH, '$' 

mess2 

DB 

'After 

shel 1 ' .ODH.OAH 


f i 1 enam 

DB 

'A:\C0MMAND.C0M' ,0 

Assume COMMAND.COM on A; 

parmb 1 k 

DW 

00 


Parameter block 


DW 

OFFSET 

com I i ne 



parmA 

DW 

00 




DW 

5CH 



parm8 

DW 

00 




DW 

6CH 



parmC 

DW 

00 



conril i ne 

DB 

09H, '/C dir A 

',0DH ; Command line 


PAGE 






DB 

128 DUP (?) 

Stack 


stack 

LABEL 

BYTE 

> 


lastloc 

LABEL 

BYTE 

; End of program 


code 

ENDS 





END 

exectest 



5.8 PROGRAMMING HINTS 

Keep the following programming hints in mind when using the MS-DOS 
Version 2,05 operating system: 

1. Serial I/O Function ]h “Set/Clear Modem Signals" does not 
work . 

2. Serial I/O Function 21 "Program Device Interrupt Vector" does 
not work. 

3. Data received from the communications port and printer port 
when the character format has been set to 7M (7 bits, 8th bit 
always Mark) always have the eighth bit set. The MPSC does 
not strip off this bit, so the application must strip it. 
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I*. The BIOS reads IBM single-sided, 8- or 9~sectored diskettes. 
However, it does NOT check to determine if a diskette in the 
specified drive is double sided. As a result, the top side 
(which contains the directory and FAT) is read if you try to 
read a double-sided IBM diskette. This falsely indicates 
that all of the data can be accessed. Copy operations do not 
work, however, because files are stored on both sides of the 
double-sided diskettes, and the data on the lower side cannot 
be read. 

5 . The MS-DOS Version 2.05 system diskette contains Z80A code 

used for starting (BOOTing) the operating system. The 

computer stops if you try to hard format a write-protected 
diskette using the /I switch. 

6. The FORMAT program on the MS-DOS Version 2.05 distribution 

diskette contains an error that fails to place an error code 

in the FAT if the last sector on the last track of a diskette 
contained a hard error. This is of minimal significance, 
since diskettes having errors in sector 10 of track 79 are 
probably extremely rare. 
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RAINBOW ON DISK STRUCTURES 


This appendix defines the layout of all software related disk 
structures. It also defines the contents of all fixed data blocks 
necessary for supporting various system configurations and 
appl i cat i ons . 


A.l INTRODUCTION 

The on-disk structure accommodates disks having larger capacitties, 
and removable media. 


A. 2 GOALS 

1. Provide a disk structure suitable for supporting multiple 
operating systems, as well as multiple logical disks. 

2. Be able to support removable (mountable) media. 

3. Support media interchange between Rainbow and non-Rainbow 
computers . 
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A. 3 CONVENTIONS 

A.3<1 Disk Address Space 

Internal pointers to disk addresses are in the form: 


Disk Addresses 

+ + + + + 4. + 

! track !sect! (3-bytes) ! length ! (opt. 2-bytes) 

+ + + + + + + 


The intersection of a cylinder and surface is a track. Each track has 
a unique number assigned to it. The numbers are assigned sequentially 
starting with track 0 located at cylinder 0 - surface 0 and proceeding 
downward within the cylinder until the last surface is reached. The 
next track is the top surface of the next cylinder. The formula for 
computing track number from cylinder and surface numbers is: 

track = surface + cylinder x (# of surfaces on disk) 

For example, the track located on surface 2 of cylinder 3 on a 
A-surface disk would be track lA. 


Disk addresses can be viewed as monotonical ly increasing block numbers 
starting at 1 (Cylinder 0, Surface 0, Sector 1) and continuing until 
the end of the last usable cylinder-surface-sector. All sectors on a 
track are used sequentially until the last sector of that track. The 
next block is then the first sector of the next track. For example 


block 
RD51) : 

i s 

then the 

f i 

rst sector 

of 

the next 

track . 

F( 

B 1 ock 

1 

-- Track 

0 

(Cy 1 i nder 

0, 

Surface 0) 

, Sector 

1 

Block 

16 

— Track 

0 

(Cy 1 i nder 

0, 

Surface 0) 

, Sector 

16 

Block 

17 

— Track 

1 

(Cy 1 i nder 

0, 

Surface 1) 

, Sector 

1 

Block 

6A 

— Track 

3 

(Cy ] i nder 

0, 

Surface 3) 

, Sector 

16 

Block 

65 

-- Track 

A 

(Cy 1 i nder 

1, 

Surface 0) 

, Sector 

1 


A. 3-2 Checksums 

Each reserved area of the on-disk structure contains a l6-bit checksum 
value in- bytes A and 5* This value is computed by zeroing the 
checksum bytes, then performing a cumulative modulo-l6 addition of the 
reserved area data. The data is treated as l6-bit quantities starting 
with bytes 0 and 1. The resulting sum is complemented and a value of 
1 is added to it. This number becomes the checksum. When a reserved 
area is read, the checksum is verified by performing the same 
modulo -16 addition, including the checksum quantity. The resulting 
sum should be zero. 
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A. it RESERVED AREAS 

Tracks 0 and 1 contain information used to configure and maintain 
system areas on the hard disk. This data is accessed by various 
utilities that need to know the extent of disk partitions and bad 
regions. This data is duplicated on tracks 3 and it. This area is not 
usable by any operating system for their respective file structures. 
The information stored on these tracks is: 

• PRE-BOOT - This block is to be read by new firmware. It 

contains a small program that reads and starts the primary 
boot program. 

• HOM - This block contains the volume ID of the disk, a 
description of the physical disk layout, and pointers to the 
other disk system areas. 

• BAT (Bad Address Table) - This area contains a bit map 
identifying all bad sectors on the disk. 

• AST (Alternate Sector Table) - This area contains the 

addresses of bad sectors on the disk along with an alternate 
sector address for each. 

• DPD (Disk Partition Data) - This area contains a description 
of each disk partition, its logical assignment, and operating 
system code. 

• OSN (Operating System Name Table) - This area contains the 

name strings of each known operation system type code found 
in the DPD. 

• BOOT - This area is reserved for the Winchester boot program. 
Other reserved areas are: 

1. PAS (Partition Alternate Sector Table) - This area contains 
the addresses of all bad sectors in the partition along with 
an alternate sector address for each. It occupies the first 
sector in the first track of each partition (CP/M and 
Concurrent CP/M only). 

2. Alternate Sector Area - This area is reserved for use as 
alternate sectors in place of known bad sectors. 

3. Maintenance Cylinder - This is the next to the last cylinder 
and is reserved for use by the hard disk diagnostic. 

4. Manufacturing Cylinder - This is the last cylinder and is 
reserved for bad spot information written during the 
manufacturing process. 
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A.A.1 Pre-Boot 

This block contains the code necessary to read in the HOM block and 
locate the Disk Boot Program. It then reads in this program from 
consecutive sectors as specified by the HOM block and starts it at a 
fixed address (to be determined at a later time). When a new HOM 
block is written to the disk, this block should be initialized with a 
small program that displays the message: “There is no bootable system 
on this disk." 


A.i+.2 Home Block (HOM) 

This block contains the data necessary to locate all other reserved 
areas on the disk. It contains the Volume ID (for removable media) as 
well as the physical disk parameters. The home block data must fit 
into 128 bytes in order to be compatible with disks that have a sector 
size of 128 bytes. If the disk sector size is greater than 128 bytes, 
then the remainder of the home block must be filled with zeros to 
maintain a proper checksum. 

Byte Contents 

0-2 HOM Block Identification (ASCII characters). 

3 Flag: $00 if partitioned; else $FF 

4-5 Checksum [Block Checksum := 0 (mod l6-bits)] 

6-13 8-character VOL ID (Default := “RAINBOW”) 

1^-17 System ID or serial number (Default := 0) 

18-22 Disk Addresses/length of BAT or 0 if none. 

23-27 Disk Addresses/length of DPD or 0 if none. 

28-32 Disk Addresses/length of OSN or 0 if none. 

33-37 Disk Addresses/length of BOOT or 0 i f none. 

38-42 Disk Addresses/length of AST or 0 i f none. 

43-44 Starting track number for alternate sector area. 

45 


Number of tracks reserved for alternate sector area. 
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Byte Contents 

46-63 Auto-boot parameters: 

46 Auto-boot Flag: $FF if no auto-boot 

$nn if auto-boot: nn is index into 
DPD entries section of DPD block 

47-48 Partition Boot Track 

64-126 Physical Disk Parameters: 

64-65 ^ of Cylinders 

66 Sectors/Track 

67-68 Sector size (bytes) 

69 # of Surfaces 

70-71 Maint. Cylinder # 

72-73 Mfg. Data Cylinder # 

74-75 Write Pre-comp value 

76 Step Rate 

77 Disk Type Code, 10 = RD 5 I; 12 = RD50 

127 Physical block # of this block (for example, 01 for HOM) 
128-511 Must be zero (MBZ) 


A. 4,3 Bad Address Table (BAT) 

This table contains a bit map identifying known bad sectors on the 
disk. The map is created by the hard disk utility program using the 
factory bad spot data and the diagnostic mapping data. The table is 
treated as an array of l6-bit words. The number of words required 
depends on the size of the disk. (For the RD51> 1224 words are 

needed.) A bit is accessed first by locating the word containing it 
and then by locating the bit position within the word. The bit 
locations are a function of the sector disk address. The word offset 
and bit position are computed as follows: 

table value = (trk number X sectors/track) + (sector number - 1) 

word offset = bits 4-23 of table value 

bit position = bits O -3 of table value 

Because the entire table cannot fit in a single sector, multiple BAT 
blocks are required. The header of each block identifies the range of 
sector addresses whose bits are represented in that block's portion of 
the table. 
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Byte Contents 

0-2 BAT Block Identification (ASCII Characters) 

3 Logical Block Number (LBN) - Relative block number within BAT 

table. (That is, the first BAT block is 0, the second is 1, 
and so forth.) 

k-S Checksum [Block Checksum := 0 (mod l6-bits)] 

6-8 Disk Address of the sector corresponding to the first bit 

entry in the block 

9“11 Disk Address of the sector cor respond i ng to the last bit entry 
in the block 

12-511 BAT entries, one bit each: 

Bit value Meaning 

0 Correspond i ng sector is good 

1 Correspond i ng sector is bad 


fii.k.k Alternate Sector Table (AST) 

This block contains an ordered list of known bad sectors on the disk 
along with an alternate good sector for each. The disk utility 
programs assign alternate good sectors to each bad sector specified in 
the BAT blocks. The bad sector/alternate sector information relevant 
to each partition is duplicated in the PAS block located at the 
beginning of the partition. 


Byte Contents 

0-2 “AST" Block Identification (ASCII Characters) 

3 Logical Block Number (LBN) - Relative block number within AST 

table. (That is, the first AST block is 0, the second is 1, 
and so forth.) 

^“5 Checksum [Block Checksum := 0 (mod l6-bits)] 

6-7 Max imum_Entry_Count - The maximum number of AST entries 

allowed in this block. (Max := 100 for 512 byte sectors.) 
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Byte Contents (Cont.) 

8-9 Entry_Count - The number of entries in this block, counting 
bad sectors with or without alternate sectors and unassigned 
alternate sectors. 

10-11 Reserved 

12-511 AST entries, 5~bytes each: 


Offset Contents 

0-2 Disk Address of bad sector: 0 means associated 

alternate sector is unassigned. 

3 Track offset of alternate good sector (from first 

alternate track) 

k Sector number of alternate good sector 


A. 4. 5 Disk Partition Data (DPD) 

This area contains the data for partitioning the disk into logical, 
assignable areas. Areas are categorized by name and OS type. This 
data is constructed at sub-system installation time or whenever the 
user wishes to repartition the disk. 


Byte Contents 

0-2 "DPD" Block Identification (ASCII Characters) 

3 Logical Block Number (LBN) - Relative block number within DPD 

table. (That is, the first DPD block is 0, the second is 1, 
and so forth.) 

4-5 Checksum [Block Checksum := 0 (mod l6-bits)] 

6-7 Max imum_Entry_Count - The maximum number of DPD entries 

allowed in this block. (Max := 15 fof 512 byte sectors.) 

8-9 Entry_Count - The number of DPD entries in this block. 

10-31 Reserved 
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Byte Contents (Cont.) 

32-511 DPD entries, 32-bytes each: 


Offset Contents 

0 Flag: $FF := Non-existent; $0F := not initialized; 

$F0 := initiali zed . 

1 Logical unit: $00 :«= Unassigned; I -63 := Assignment 

within OS (For CP/M: 1 = A, 2 = B, 3 = 

C, and so forth.) 

2-9 Partition name (ASCII Alphanumeric characters) 

[Default := "DISKnn"; nn := 01, 02, etc.] 

10 Partition occurrence number (i .e. 0,1,2,... for 

partitions of the same name). 

11 OS type code: Index into OS Name table (OSN) 

12-13 First track number 

llf-15 Last track number 

16 Number of PAS blocks at the beginning of the partition 
(CP/M and Concurrent CP/M partitions only) 

17 if Concurrent CP/M partition, directory size code: 

0 = default (256 entries for <5MB partition, 

512 for > 5 ME partition) 

1 = 256 entries 
2=512 entr i es 

3 = 1024 entries 

4 = 2048 entr i es 

18 if MS-DOS partition, cluster size code: 

0 = 2KB cluster 

1 = 4KB cluster 

2 = 8KB cluster 

3 = 16KB cluster 

19 if MS-DOS partition, number of FAT sectors (only if 
Version 3*0 or later of Hard Disk Utility is used) 

20-31 Reserved for Backup/Restore system. 
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A. A. 6 Operating System Name Table (OSN) 

This area contains the operating system name string table representing 
the operating system type codes found in the DPD. This table may be 
sparsely populated, therefore, it is not necessary to allocate 
consecutive entries. Each entry is a zero filled l6-byte text string. 


Byte Contents 

0-2 “0SN“ Block Identification (ASCII Characters) 

3 Logical Block Number (LBN) - Relative block number within OSN 

table, (That is, the first OSN block is 0, the second is 1, 
and so forth.) 

4-5 Checksum [Block Checksum := 0 (mod l6-bits)] 

6-7 Max i mum_Entry_Count - The maximum number of OSN entries 

allowed in this block. (Max := for 512 byte sectors.) 

8-15 Reserved 

16-511 OSN entries (l6-bytes). Operating system name strings created 

by the partition utility. Name strings may consist of 1 to I6 
ASCII characters excluding CONTROL, SPACE and DEL characters. 


A. 4. 7 System Boot Program Area 

This area contains a secondary bootstrap routine. This routine asks 
you what operating system and partition should be used for booting. 
It optionally uses the "Auto-boot“ data if present in the HOM block. 
Whenever this area is created, the PRE-BOOT block (O) should also be 
wr i tten . 
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A. 4. 8 Track Layout 

For a TOM byte RD51 disk with 16 sectors of 512 bytes each per track. 


Track 0: 


1 2 3 5 6 7 8 

IPBOOT ! HOM IDPD (0) !DPD (1) !OSN (0) !BAT(0) !BAT{1) !BAT(2) ! 


9 10 11 12 13 11* 15 16 

+ + + + + + + + + 

I BAT (3) I BAT (A) I AST (0) I AST (1) I AST (2) I * | * | * | 

+ + + + + + + + + 


Track 


* = reserved 


1 2 3 1* 5 6 7 8 

+ + + + + + + + + 

! Secondary Bootstrap Program ! 

+ + + + + + + + 

9 10 11 12 13 11* 15 16 

! Secondary Bootstrap Program ! 


Track 2: 

Track 3: 

Tracks 4-19: 
Tracks 20-1215: 
Tracks 1216-1219: 
Tracks 1220-1223*. 


same as track 0 
same as track 1 
Alternate sectors 
Parti tions 
Maintenance tracks 
Manufacturing tracks 
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For a 5M byte RD50 disk with 16 sectors of 512 bytes each per track. 


Track 0: 


1231+5678 

+ + + + + + + + + 

IPBOOT ! HOM !DPD(0) !DPD(1) !0SN(O) !BAT(0) !BAT(1) !BAT(2) ! 
+ + + + + + + + + 


9 10 11 12 13 11+ 15 16 

4, ^ ^ -f- ^ j 1 4. 

|AST(0) |AST(1) I * I * I * I * I * I * I 

+ 1- H + + + + + + 

* = reserved 

Track 1: 

1231+5678 

! Secondary Bootstrap Program ! 

9 10 II 12 13 11+ 15 16 

+ — -4. ^ f- ^ 1 ---f 1 — + 

! Secondary Bootstrap Program ! 

Track 2: same as track 0 

Track 3* same as track 1 

Tracks 4-12: Alternate sectors 

Tracks 20-603: Partitions 

Tracks 60 A- 607 : Maintenance tracks 
Tracks 608 - 6 II: Manufacturing tracks 


A. 4. 9 Partition Alternate Sector Table (PAS) 

This block contains an ordered list of known bad sectors within the 
partition along with an alternate good sector for each. This 
information is a subset of that which is contained in the AST block. 
It is provided for use by the operating system to prevent use of known 
bad sectors. It is located in the first sector on the first track of 
a CP/M or Concurrent CP/M partition. There is no PAS block for MS-DOS 
parti t i ons . 
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Byte Contents 

0-2 "PAS" Block Identification (ASCII Characters) 

3 Logical Block Number (LBN) - Relative block number within a 

possible sequence of PAS blocks (That is, the first PAS block 
is 0, the second is 1, and so forth.) 

k~S Checksum [Block Checksum := 0 (mod l6-bits)] 

6-7 Maximum_Entry_Count - The maximum number of PAS entries 
allowed in this block. (Max := 100 for 512 byte sectors.) 

8-9 Entry_Count - The number of PAS entries in this block. 

10-11 Reserved 

12-511 PAS entries, 5“bytes each; 

Offset Contents 


0-2 Disk Addresses of bad sector 

3 Track offset of alternate good sector (from first 
alternate track) 

4 Sector number of alternate good sector 


A. 4. 10 Operating System Bootstraps 

Individual operating system bootstraps reside on reserved areas within 
their respective partitions, starting at the first sector after the 
PAS block in the partition. 
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MICROSOFT ARTICLES FOR PROGRAMMERS AND OEMS 


This appendix includes articles written by Microsoft Corporation. 
Generally, they cover the same information covered in the MS-DOS 
"Programmers Reference Manual." They are included since they provide 
additional, useful information. 


B.l CONFIGURATION FILES IN MS-DOS VERSION 2.0 

The following are a list of commands for the configuration file 
CONFIG.SYS: 

BUFFERS = <numbef> 

This is the number of additional sector buffers to add to the 
system list. The effect of several BUFFERS commands is to 
allocate a series of buffers. 


F I LES = <number> 

This is the number of open files that the XENIX system calls can 
access . 


DEVICE = <f i lename> 

This installs the device driver in <filename> into the system 
list. 


BREAK = <0N or 0FF> 

If ON is specified (the default is OFF), a check for ^C at the 
console input is made every time the system is called. ON 
improves the ability to abort programs over previous versions of 
the DOS. 
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SWITCHAR = <char> 

Causes the DOS to return <char> as the current switch designator 
character when the DOS call to return the switch character is 
made. Defaul t is '/' • 


AVAILDEV = <true or false> 

The default is TRUE, which means both \dev\<dev> and <dev> 
reference the device <dev>. If FALSE is selected, only 
\dev\<dev> refers to device <dev>, <dev> by itself means a file 
in the current directory with the same name as one of the 
dev i ces . 


SHELL = <f i 1 ename> 

This begins execution of the shell (top-level command processor) 
from <filename>. Used when COMMAND.COM is not in the current 
d i rectory . 

A typical configuration file might look like this: 

BUFFERS = 10 
FILES = 10 

DEVICE = \bi n\network.sys 
BREAK = ON 
SWITCHAR = - 

SHELL = a:\bin\C0MMAND.C0M a:\bin /p 

The default value for BUFFERS is OEM specific in that the OEM can 
specify the number in the BIOS. A typical value is 2, the minimal 
value is one. (The Rainbow's default is 4). The default value for 
FILES is usually 8 (as above, it may be set by OEM BIOS) , so "FILES = 
10" actually allocates only 2 new file channels. If a number less 
than, or equal to, five is specified, the command is ignored. (The 
Rainbow's default is 8). BREAK defaults to OFF, SWITCHAR to /, and 
AVAILDEV to TRUE. Notice that the setting of SWITCHAR may effect 
characters used on the SHELL line (this is true of C0MMAND.COM). 


B.2 VERSION INCOMPATIBILITIES 

Areas where Version 2.0 is not compatible with previous versions of 
the DOS. 

• Direct calls to the BIOS 

Any program which jumped directly to the BIOS by way of the 
jump table at 40:0 no longer works. 

\ 
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• FAT poi nter calls 

Programs that used system calls 27 and 28 to get a pointer to 
the FAT no longer work. Because the FAT is now cached with 
other disk resources, there is no fixed location in memory to 
pass the address to. The calls still exist, however, and 
have the same format. THEY CAN ONLY BE USED TO GET THE FAT 
ID BYTE. On return ES:BX points to a FAT ID BYTE for the 
Drive. Doing anything except READing this ONE byte will 
probably crash the system. In order to get at the FAT, 
programs first call DSKRESET (call 13) to flush out any dirty 
buffers, and then make a GETDPB call (call 31 or 50) to find 
out which sector on the disk the FAT starts at, how big it 
is, and how many copies of it there are. Then I NT 25H and 
I NT 26H can be used to transfer the FAT in and out of the 
programs memory space. 

• I NT 25H and I NT 26H 

In order for the above to work, and in order to maintain some 
order in the world of mu 1 1 i -surf ace disks, it is required 
that I NT 25H and 26H use the MS-DOS sector mapping rather 
than some rather arbitrary head-cylinder-sector mapping. 

The following subroutine reads the FAT into the area of memory 
specified by DS:BX. DL contains the drive number, DL=0 means read the 
FAT from the default drive, DL=1 indicates read from drive A:, and so 
on. 


getf at : 

push bx 

push ds 

mov ah , 50 

i nt 2 1 h 

mov cx,[bx+15] 

mov dx,[bx+6] 

pop ds 

pop bx 

mov a 1 , d 1 

or al ,al 

jnz driveok 

mov ah , 1 9h 

int 21h 

i nc al 

dr i veok: 

dec a 1 

int 25 h 

pop ax 

ret 


; save pointer to FAT area 

; request the dpb 

; get FAT sector count 
; first sector of FAT 
; restore FAT area pointer 

; is it the default drive? 

; if not, load FAT 

; ask for default drive 

; get the default drive 

; map a=0 to a=l 

; map a=l to a=0 

; read the FAT into DSrBX 
; clean up the stack 
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B.3 DIFFERENCES AND ADDITIONS TO INT 24H HARD ERROR HANDLER (S) 

For MS-DOS 2.0 
Additional Constraints: 

Under previous versions it was not explicitly stated that an INT 
24H handler must preserve the ES register. It is now required 
that INT 2AH handlers preserve ES. 

When it is desired to ignore an error, the same registers must be 
preserved as when it is desired to retry the operation 
(SS,SP,DS,BX,CX,DX) . 

It was not clearly stated in the past, but it was true that only 
system calls 1-12 can be made by an INT 24H handler. Making any 
other calls destroys the DOS stack and its ability to retry or 
ignore an error. 

INT 2lfH handlers should always return to the DOS on a retry, 
ignore, or abort. Failure to return to the DOS leaves the DOS in 
an unstable state until a non 1-12 function call is made. 


Additional features: 

Character device errors are now handled by the INT 24H mechanism. 
Previously only disk I/O errors were handled by the INT 2AH 
handler. Additional information is now passed to the INT 24H 
handler in the BP and SI registers (which need not be preserved). 

BP:5I is a DWORD pointer to the Device Header of the device 
causing the error. information can be gotten from this header to 
determine whether or not the device is a block or character 
device; if the device is a character device, the name of the 
device can also be obtained. The DEVICE-DRIVERS document for 2.0 
contains the definition of this header format. 

NOTE 

AL (drive number for Disk errors) is 
indeterminate on character device errors. Bit 7 
of AH is always 1 for character device errors. 
Previously bit 7 was 1 only in the case of a bad 
memory image of the FAT. 
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LIST OF INT 2kH ERROR CODES PASSED IN Dl 

0 Write protect violation 

1 Unknown unit 

2 Drive not ready 
^ 3 Unknown command 

CRC error 

5 Bad drive request structure length 

6 Seek error 

* 7 Unknown media 

8 Sector not found 

9 Printer out of paper 
A Write fault 

5'? B Read fault 

C General f a i 1 ure 

Denotes New Function 

As mentioned above BP:SI points to the device header: 


BP:SI-> 

+ + 

I DWORD Pointer to next device | 

I (-1 if last device) j 

^ + 

I WORD Attributes | 

I Bit 15 = 1 if char device, 0 if blk j 
I if bit 15 is 1 I 

I Bit 0 = 1 if Current sti device j 

I Bit 1 = 1 if Current sto output j 

I Bit 2 = 1 if Current NUL device | 

I Bit 3 = 1 if Current CLOCK dev j 

j Bit 14 is the lOCTL bit (see below) j 

I Bit 13 is the NON IBM FORMAT bit j 

4. 4- 

I WORD Pointer to Device strategy | 

I entry point j 

4. 4. 

I WORD Pointer to Device interrupt | 

I entry point j 

4. 4. 

I 8-BYTE character device name field | 

I Character devices set a device name j 
I For block devices the first byte is j 
I The number of units j 

4. 4- 

To tell if the error occurred on a block or character device you 
look at bit I5 in the attribute field (WORD at BP:SI+4), 

If the name of the character device is desired, look at the 
bytes starting at BP:SI+10. 
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B.k MS-DOS 2.0 UTILITY EXTENSIONS 

The following notation is used below: 

[item] item is optional 

item- item is repeated 0 or more times 

i tem+ item is repeated 1 or more times 

{iteml I i tem2} iteml is present or item 2 is 
present, but not both 

<object> indicates a syntactic variable 

BATCH COMMAND invocation 

COMMAND [[<dr i ve>:]<path>] [<CTTYDEV>] [/D] [/P] [/C <string>] 

/P If present, COMMAND is permanent, otherwise this is a 
transient command. 

/D If present, COMMAND does not prompt for DATE and TIME when it 
comes up. 

drive; Specifies device where command looks for COMMAND.COM 
current default drive if absent. 

<path> Specifies a directory on device drive: root directory if 

absent. 

<CTTYDEV> Name of the CTTY device. /DEV/CON if absent and 
command is permanent. The /DEV/ may be left off if AVAILDEV is 
TRUE (see AVAILDEV above). 

/C <string> If present, /C must be the last switch. This causes 
COMMAND to try to execute the string as if the user had typed it 
at the standard input. COMMAND executes this single command 
string then exits. If the /P switch is present it is ignored 
(can't have a single command, permanent COMMAND). 

NOTE 

ALL of the text on the command line after the /C 
is just passed on. It is not processed for more 
arguments, this is why /C must be last. 

Redirection of standard input/standard output. 

Programs that read from the keyboard and write to the screen are 
said to be doing I/O to the standard input and standard output. 
Using any of the following results in I/O to these standard 
devi ces: 

Writing to default handles 1 / read from default handle 0. 
Doing byte I/O using system calls 1, 2, 6-12. 
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These standard devices may be redirected to/from files by the 
following in command line arguments: 

> <f i 1 ename> 

causes <filename> to be created (or truncated to zero 
length) and then assigns standard output to that file. All 
output from the command is placed in the file. 

< <f i 1 ename> 

causes standard input to be assigned to <filename>. All 
input to the command comes from this file. If end-of-file 
is reached, then system calls 1, 2, 6-12 returns ^Z, while 
reading from handle 0 returns zero characters. 

» <f i 1 ename> 

causes <filename> to be opened (created if necessary) and 
positions the write pointer at the end of the file so that 
all output is appended to the file. 

Notice that the above does not appear in the command line that 
the program being invoked sees. 

Exampl es : 

DIR ^^.ASM >F00.LST 

Sends the output of the dir command to the file FOO.LST. 

FOR %0 IN (5V.ASM) DO MASM %0; »ERRS.LST 

Sends all error output from assembling every .ASM file into 
the file ERRS . LST . 

Piping of standard I/O 

It is often useful for the output of one program to be sent 
as input to another program. A typical case is a program 
that produces columnar output that must later be sorted. 

The pipe feature allows this to occur naturally as the 
programs do all of their I/O to the standard devices. 

For example, if we had a program SORT that read all of it's 
standard input, sorted it and then wrote it to the standard 
output, we could get a sorted directory listing as follows: 

DIR I SORT 
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The I would cause all standard output generated by the 
left-hand command to be sent to the standard input of the 
right-hand command. 

If we wanted the sorted directory to be sent to a file, we 
type: 

DIR I SORT >FILE 
and away it goes. 

The piping feature is implemented as sequential execution of 
the procedures with redirection to and from temporary files. 
In the example above, the following would be an exact 
equivalent: 

DIR >\tmp\stdl 

SORT >\tmp\stdl >F I LE 

The pipe is not a real pipe but rather a quasi-pipe that 
uses temporary files to hold the input and output as it 
sequentially executes the elements of the pipe. These files 
are created in the current directory, of the current drive 
and have the form %PIPEx%.$$$, where x is 1 or 2. This 
means that any program that runs in the pipe must be sure to 
restore the current directory and drive, if it has changed 
them, or the pipe files are lost. 


COMMAND extensions 
BREAK [{ON j OFF}] 

"BREAK ON" turns on the Control C check in the DOS function 
dispatcher. "BREAK OFF" turns it off. If no argument is given 
the setting of BREAK is printed to the standard output in the 
form: 


BREAK is XXX 

Where xxx is "on" or "off". 


CHDIR [{<drive>: | <path>}] 

Change directory, or print current directory. If no argument is 
given, the current directory on the default drive is printed. If 
drive: alone is given, the current directory of drive is 

printed. Otherwise the current directory is set to path. 

"CD" is accepted as an abbreviation. 
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CLS 


Clear screen causes the ANSI escape sequence ESC[2J to be sent to 
standard output. 


COMMAND internal commands take path arguments. 

DIR <path> 

COPY <path> <path> 

DEL (ERASE) <path> 

If the path is a dir, all files in that dir are deleted. 

NOTE 

The "Are you sure (Y/N) " prompt for DEL and ERASE 
now uses buffered standard input, so users must type 
a return after their answer. This gives them the 
chance to correct if they type 'y' by mistake. 

TYPE <path> (must specify a file) 


CTTY \DEV\dev - Change console TTY. For instance: 

CTTY \DEV\AUX 

Would move all command I/O to the AUX port. 

CTTY \DEV\C0N 

Would move it back to the normal device. The \dev\ prefix 
may be left off if AVAILDEV is TRUE (see configuration-file 
doc) . 


ECHO [{ON I OFF | <message>}] 

Normally, commands in a BATCH file are echoed onto the standard 
output as they are seen by COMMAND. ECHO OFF turns off this 
feature. ECHO ON turns echoing back on. I f ON or OFF is not 
specified and there is text following the command, that text (a 
message) is echoed to standard output. If there are no arguments 
at all, the current setting of echo (on or off) is echoed to the 
standard output in the form: 

ECHO is XXX 

Where xxx is "on" or "off". 
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EXIT 


For COMMANDS run without the P switch, this causes COMMAND to 
return. For a normal COMMAND it causes a return to itself. 


GOTO <label> 

Causes commands to be taken from the batch file beginning with 
the line after the <label> definition. If no label has been 
defined, the current batch file terminates. 

Example: 

: f oo 

REM loop! ng. . . 

GOTO foo 

produces an infinite sequence of messages: 

REM 1 oop i ng . . . ‘ 


NOTE 

Labels are case insensitive, :F00 == :foo == :Foo 


IF <condition> <command> 

where <condition> is one of the following: 

ERRORLEVEL <number> 

true if and only if the previous program EXECed by COMMAND 
had an exit code of <number> or higher. 

<stringl> == <string2> 

true if and only if <stringl> and <string2> are identical 
after parameter substitution. Strings may not have embedded 
del imi ters . 

EXIST <f i 1 ename> 

true if and only if <filename> exists. 

NOT <condition> 

true if and only if <condition> is false. 
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The IF statement allows conditional execution of commands. When 
the <condition> is true, then the <command> is executed 
otherwise, the <command> is skipped. 

Examples: 

IF not exist \tmp\foo ECHO Can't find file \tmp\foo 
IF $lx == X ECHO Need at least one parameter 
IF NOT ERRORLEVEL 3 LINK $1,,; 

FOR %%<c> IN <set> DO <command> 


<c> can be any character but 0,1,2,3»**>9 (so there is no 
confusion with the %0 - %9 batch parameters). 

<set> is ( < i tem> 2 >v ) 

The %%<c> variable is sequentially set to each member of 
<set> and then <command> is evaluated. If a member of <set> 
is an expression involving * and/or ?, then the variable is 
set to each matching pattern from disk. In this case only 
one such <item> may be in the set, any <item>s after the 
f i rst are i gnored . 


Example: 


FOR %%f IN ( >’^.ASM ) DO MASM %%f; 

for %%f in (FOO BAR BLECH) do REM Uf to you 

NOTE 


The '%%' is needed so that after Batch parameter (%0 
- % 9 ) processing is done, there is one left-. 'If 
only '%f' were there, the batch parameter processor 
would see the then look at 'f', decide that '%f' 
was an error (bad parameter reference) and throw out 
the '%f so that FOR would never see it. If the FOR 
is NOT in a batch file, then only ONE should be 
used . 


<label> 


This is essentially a no-op. It defines a 
file for a subsequent GOTO. It may also 
lines in batch files since all lines that 
i gnored . 


label in the batch 
be used to put comment 
start with ' : ' are 
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MKDIR <path> - Make a directory. 

"MO" is accepted as an abbreviation. 


PATH [<path>{;<path>} *] 

Set command search paths. This allows users to set directories 
that should be searched for external commands after a search of 
the current directory is made. The default value is NO PATH. In 
addition there are two special cases: PATH with no arguments 

prints the current path. Path with the single argument 
(i.e., "PATH ;") sets the NUL path (no directories other than the 
current one searched). If no argument is given, the current 
value of PATH is printed to the standard output in the form: 

PATH=text of path 
or 

No path 


PROMPT C<prompt-text>3 


Set the system prompt. MS-DOS prompts are now user settable, all 
of the text on the command line is taken to be the new prompt. 
If no text is present the prompt is set to the default prompt. 
There are meta strings for various special prompts. These are of 
the form '$c' where c is one of the following: 

$ - The '$' character. 


t - The time, 
d - The date. 

p - The current directory of the default drive. 
V - The version number. 


n - The default drive. 


g - The '>' 

1 - The '<' 
b - The ' 1 ' 
s - The ' ' 
e - The ESC 
- A CR LF 


character . 
character . 
character . 
character . 
character . 
sequence. 
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EXAMPLE: 

PROMPT $n> 

Would set the normal MS-DOS prompt. 

PROMPT Time = $t$_Date = $d 

Would set a two line prompt which printed 
Time = (current time) 

Date = (current date) 

For '$c' sequences, lower case = upper case, and any character 
not on the above list is mapped to nothing. 

RMDIR <path> - Remove a directory. 

"RD" is accepted as an abbreviation. 

The directory must be empty except for and 

<path> - A standard XENIX style path with the optional addition 
of a drive spec: 

A:\F00\BAR Full path 

\F00\BAR Full path, current drive 

FOO\BAR Current dir relative 

A:F00\BAR 

SET (ENVNAME) = (ENVTEXT) 

Set environment strings. 

This command inserts strings in COMMAND'S environment. For 
i nstance: 

SET PR0MPT=$n> 

Duplicates the function of the PROMPT command. 

SET PATH=pl;p2 

Duplicates the function of the PATH command. 
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SET foo=bar 

Puts the string FOO=bar into the environment (notice the 
case mapping of (ENVNAME) ) . 


NOTE 

Environments are very flexible, and almost anything 
can be put into the environment with the SET 
command; the only requirement is that a single '=' 
be present in the string. 


SHIFT 


Currently, command files are limited to handling 10 parameters: 
%0 through % 9 - To allow access to more than these, the command 
SHIFT performs a 'pop' of the command line parameters: 

if %0 = "f oo 
%1 = "bar" 

%2 = "blech" 

. ,%S are empty 

then a SHIFT results in the following: 

%0 = "bar" 

%1 = "blech" 

%2. . .%9 are empty 

If there are more than 10 parameters given on a command line, 
those that appear after the 10th (%9) are shifted one at a time 
into %9 by successive shifts. 


VER 


Prints DOS version number. 


VERIFY [{ON I OFF}] 

Select/Deselect verify after write mode. This supplements the V 
switch to the COPY command. Once turned ON, it stays on until 
some program changes it (via the set verify system call) or the 
VERIFY OFF command is given. If no argument is given, the 
current setting of VERIFY is printed to. the standard output in 
the form: 

VERIFY is XXX 

Where xxx is "on" or "off". 
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VOL [<drive>:] 

Prints the volume ID of the disk in drive:. No drive: 
the default drive. 


i t does 
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Directory entries, 3“l8 
Directory fields, 3“19 
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Disk files, 3“l6 
Disk organization, 3~17 
Distribution diskette contents, 
3-5 

DOS, 3-1, 3-1it. 3-16 
Editing keys, 3-13 
Extended file control block, 
3-25 

FAT. 3-17, 3-21 
File attributes, 3~21 
File control block, 3-24 
Function keys, 3“13 
Generic commands, 3~8 
Interlace, 3-23 
Interrupt types, 3-28 
Interrupt vector assignment, 
3-29 

Loader, 3-2 
Loading, 3-2 

Logical device assignment, 3-25 
Memory map, 3-4 
Modifying interrupt vectors, 
3-30 

Operation of, 3-1 
Overview, 3-1 

Physical device assignment, 

3- 25 

Sector translation, 3~23 
Standard files, 3-5 
Structure of, 3-14 
System functions, 3”27 
V2.0, 3-2 
V2.01, 3-2 
V2.05, 3-2 

V2.05 additional commands, 3-12 
Wildcards, 3-25 
MS-DOS V2.05 

ALTERNATE CONTROL CHARACTERS 
FOR XON/XOFF PROTOCOL, 4-4 
Baud rates, 4-9 
BREAK DETECTION, 4-4 
BREAK TRANSMISSION, 4-4 
BUFFER SIZE, 4-5 
CCB, 4-6 

Device drivers, 4-1 
Disk control functions, 4-24 
Extended DOS functions, 4-1 
FUNCTION 00 - PROGRAM DEVICE, 

4- 12 

FUNCTION 01 - PROGRAM DEVICE TO 
DEFAULT NVM SETTINGS, 4-13 
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FUNCTION 02 - SET DEVICE TO USE 
DEFAULT BUFFER, 4-13 
FUNCTION 03 - READ DEVICE 
SET-UP VALUES, 4-14 
FUNCTION 04 - ENABLE RECEIVER 
INTERRUPTS, 4-14 
FUNCTION 05 - DISABLE RECEIVER 
INTERRUPTS. 4-15 
FUNCTION 06 - READ INPUT DEVICE 
STATUS, 4-15 

FUNCTION 07 - READ INPUT 

CHARACTER, RETURN IF NONE 
AVAILABLE, 4-15 
FUNCTION 08 - GET CHARACTER, 
RETURN WHEN AVAILABLE, 4-l6 
FUNCTION 09 - READ OUTPUT 
DEVICE STATUS, 4-l6 
FUNCTION 10 - WRITE CHARACTER, 
RETURN IF UNABLE TO, 4-1? 
FUNCTION 11 - PUT CHARACTER, 
RETURN WHEN SUCCESSFUL, 

4-17 

FUNCTION 12 - TRANSMIT 

CHARACTER IMMEDIATELY, 4-l8 
FUNCTION 13 - READ MODEM 
SIGNALS, 4-l8 

FUNCTION 14 - SET/RESET MODEM 
OUTPUT SIGNALS, 4-19 
FUNCTION 15 - TRANSMIT BREAK, 
4-19 

FUNCTION 16 - CEASE 

TRANSMISSION OF BREAK, 4-20 
FUNCTION 17 - SET RECEIVE 

CHARACTER INTERRUPT, 4-20 
FUNCTION 18 - CANCEL RECEIVE 
CHARACTER INTERRUPT, 4-21 
FUNCTION 19 - TRANSMIT BUFFER 
BECOMING EMPTY INTERRUPT, 
4-21 

FUNCTION 20 - CANCEL TRANSMIT 
BUFFER BECOMING EMPTY 
INTERRUPT, 4-22 

FUNCTION 21 - SET USER DEFINED 
INTERRUPT SERVICE ROUTINE, 
4-22 

FUNCTION 22 - RESET DEVICE 
INTERRUPT VECTORS, 4-23 
FUNCTION 23 - SET EXTERNAL 
STATUS CHANGE INTERRUPT, 
4-23 
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FUNCTION 2k - CANCEL EXTERNAL 
STATUS CHANGE INTERRUPT, 
l*-24 

FUNCTION 25 - NON-DESTRUCTIVE 
READ, NO WAIT, 4-24 
FUNCTION 44H - lOCTL, 4-1, 4-2 
MODEM SIGNAL CONTROL, 4-4 
Modem signals, 4-1 1 
Programming ports, 4-4 
Protocols, 4-3 
RECEIVE AUTO XON/XOFF, 4-4 
RECEIVE CHARACTER INTERRUPT, 

4-5 

Serial 1/0 devices, 4-2 
TRANSMIT AUTO XON/XOFF, 4-4 
TRANSMIT BUFFER EMPTY INTERRUPT, 
4-5 

MSDOS.SYS, 3-2, 3-3. 3-4, 3-5. 

3-14 

Mu 1 1 i -Protocol Serial Controller, 

1- 14 

National -replacement-character , 

2 - 2 

Networking, 1-1 8 
NVM, 1-7 

OSN 

Operating system name table, 

A-3. A-9 
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PAS 

Partition alternate sector 
table, A-3, A-11 
PATH, B-12 

Physical device assignment, 3-25 

PRE-BOOT, A-3, A-4 

PRINT, 3-10 

Print Screen key, 2-2 

Print Screen key flag bit, 2-15 

PRN, 3-13 

Processors 

Clock Rate, I -5 
Programming hints, 5 -IO 
Programming notes, 5“1 
PROMPT, B-12 
Protocols, 4-3 
PSP 

Program segment prefix, 3-15 


RAM, 1-5 

Adapter card, I -5 
Banks, I -5 
Contention, 1-6 
DMA, 1-7 
Dynamic, 1-6 
Expansion kits, I -5 
Non-maskable interrupts, 1-6 
Optional, I -5 
Parity checking, 1-6 
Private, 1-6 
Shared, 1-6 
Static, 1-6 
RAM expansion, 2-15 
Raw Key buffer, 2-5 
RDCPM, 3-2, 3-5, 3-11, 3-12 
RECOVER, 3-10 
Refresh routines, I -9 
RMDIR, B -13 
ROM, 1-7 

Sample program, 5-8 
Sector translation, 3“23 
Serial I/O, 3-25 
Serial I/O devices, 4-2 
SET, B -13 
Set-up key, 2-11 
Shelling, 5-8 
Shift-lock, 2-2 
SORT, 3-10 
Spec i f i cat i ons 

Disk structures, A-1 
Stack, 2-14 

System boot program area, A-9 
System diskette, 3-2 
System functions, 3“27 
System parameter data, 2-14 
System reset, I-I 6 

Track layout, A-IO 

Universal Asynchronous Receiver 
Transmitter, 1-8 
Universal Synchronous 

Asynchronous Receiver 
Transmitter, 1-14 

V2.0, 3-2 

Configuration files, B-1 
Utility extensions, B-6 
V2.01, 3-2 

V2.01 Diskette functions, 4-25 


I ndex-4 



V2.05. 3-2 

Watchdog timer. 

1-16 

Additional commands, 

Wildcards, 3~25 


V2.05 Diskette functions, A-26 

Winchester disk 

function 

V2.05 Winchester disk functions, 
A-27 

VER, B-14 

Video display memory, 1-7 

V2.05, 4-27 


VOL, B-15 

XON/XOFF, 1-14 
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Warning: No STACK segmont 


St art 

OOOOOH 

02560H 


Stop Length 
02SSCH 2S50H 
02D53H 07F4H 


Name 

CODE 

SYSINITSEG 


C lass 
CODE 

SYSTEM INIT 


Origin Group 
0000:0 CGROUP 


Address 


Publics by Name 


OOOO : 10F9 
OOOO ; 10E9 
0000:0081 
0256 :O7E0 
0256 :07CE 
0256 ;0786 
0256 ; 07AD 
OOOO : 2236 
OOOO ; 1 E8E 
OOOO : 1 E7B 
OOOO : 2036 
0256 :O012 
OOOO : 1 105 
OOOO : 1 348 
OOOO : 1 323 
OOOO : 1322 
OOOO : 1 325 
OOOO :OCFE 
0000:0594 
OOOO : 1 105 
0256 :07AA 
0256 :0005 
OOOO : 1 603 
OOOO : 1 603 
OOOO : 0093 
0256 :O01 1 
0256 : 0005 
0000:0015 
OOOO : 1C62 
OOOO : 1 CA4 
OOOO : 1 59D 
OOOO : 1 SAE 
OOOO: 15BF 
OOOO : 2433 
0000:0294 
0000:0298 
OOOO : 029C 
OOOO : 02 AO 
OOOO : 02A4 
0OOO:O2A8 
0000:0004 
OOOO : 242F 
OOOO :05BE 
0000:0050 
0000:0418 
0000:0550 
OOOO:O0C8 
0000:0932 
0000:2236 
OOOO : 2435 
OOOO : 1 1 C3 
0256:0013 
0256:0009 
0000:2420 
OOOO: 1045 
0000:0A85 
0000:0A83 
0000:0A93 
OOOO : 1 F 1 5 


AUX 

AUX2 

AUX2DEV 

BAOCOM 

BAOLD 

BAOOPM 

BAOS I Z 

BIOSINIT 

BRKOFF 

BRKON 

BUFFER 

BUFFERS 

CLK 

CLKISR 
CLK 16 20 
CLK^OO^SO 

clk"’ao J 

CLTPN 

CMDSTR 

CON 

CRLFM 

CURRENT DOS LOCATION 

datbcom“ ~ 

OATBPRT 
OECDISK 
OEFAULT DRIVE 
DEVICE TiST 

devlst” 

DFLT7201 

DFLTBUF 

DFLTCOM 

DFLTPRT 

DFLTXCOM 

DMAAOR 

D0S2OVEC 

D0S21VEC 

D0S24VEC 

D0S25VEC 

D0S26VEC 

D0S27VEC 

DOS POINTER 

DRVNO 

DSK 

DSKDEV 
OSKTBL 
DSKTMR 
DSK INIT 

dsk“int 

ENDBIOS 

EXSTAT 

FASTCON 

FILES 

F1NA4_00S LOCATION 
FNCCOD “ 

CETCHAR 

CETFTN 

6ETFTNO 

GETPEA 

HACK7201 


0000:0079 


HDRIVES 

0000:08DE 


HDSKO 

0000:00SF 


HDSKDEV 

0000:0099 


HD INIT 

O0OO:0BEE 


HFORMAT 

O0OO:0C5F 


HINIT 

0000:0A9D 


HIOCTL 

0000:0C34 


HMCHK 

OOOO : OODD 


HNFMT 

0000:0941 


HREAO 

0000:0039 


HVDISK 

OOOO: 13EF 


HVECTOR 

0000:0B8E 


HWRITE 

0000:0997 


HWRITEV 

OOOO : 2429 


I89FKT 

OOOO; 1D1 1 


INCHAR 

OOOO : 1P9A 


INITCOH 

0000:040F 


INITT9L 

OOOO : 092A 


INI TAB 

OOOO: 1CF0 


INSTAT 

OOOO : 02AD 


INT20 

OOOO : 02D4 


INT21 

OOOO : 02F9 


INT24 

0000:0322 


INT2S 

0000:0349 


INT26 

0000:0370 


INT27 

0000:0013 


INTHDL 

OOOO: 1399 


INTRET 

0000:2446 


lOINIT 

0000:0936 


MAXTRK 

OOOO : O8C0 


MC FLG 

0256 :OOOF 


MEMORY SIZE 

0000:0004 

Abs 

MNPARTS 

0000:0E7D 


NDRV 

0000:2432 


NSECT 

OOOO : 1 5D0 


NVMCOM 

OOOO : 15E 1 


NVMPRT 

OOOO: 15F2 


NVMXCOM 

OOOO: 1090 


OUTCHAR 

OOOO : 1399 


OUTHEX 

OOOO : 1DEC 


OUTNOW 

OOOO : 1092 


OUTSTAT 

OOOO : 242D 


PACKET 

OOOO : 2429 


PACKET ADR 

OOOO : 24 1 D 


PACKET BASE 

OOOO : 0A1 D 


PARTITION 

OOOO ; 0006 

Abs 

PART SIZE 

OOOO : 13FF 


PCCOM 

OOOO: 1489 


PCPRT 

OOOO: 1513 


PCXCOM 

OOOO : 0100 


PHYSD ISK 

0000:0939 


PRECOMP 

OOOO: 19C1 


PRG7201 

OOOO ; 10F1 


PRN 

OOOO: 1613 


PRTBAUD 

OOOO : 1 609 


PRTYCOM 

OOOO : 1 609 


PRTYPRT 

OOOO: 13E2 


PSTR 

OOOO : 0O1 1 


PTRSAVE 

OOOO: 1DE2 


PUTCHAR 

OOOO : 0400 


R100 

OOOO: 1ECA 


RCVCANCEL 

OOOO: 1CE6 


RCVDIS 

OOOO: 1CD5 


RCVENA 

OOOO: 1EA7 


RCV INT 

OOOO: 1E33 


RDMODEM 

OOOO: 1 630 


RDNVMCOM 

OOOO : 1 COS 


RDSETUP 

O0OO:0A35 


RDXLT 

OOOO : 0396 


RE INIT 

OOOO : 0E7E 


RHOME 

OOOO : 1 6E9 


RUPT7201 

OOOO : 2430 


SECNO 

OOOO: IE 60 


SETMOOEM 

OOOO: 1F9D 


STATCHG 

OOOO : 242E 


STATUS 

OOOO : 1F90 


STCANCEL 

OOOO : 0938 


STEPRATE 

OOOO : 0006 


STRATEGY 

0256 : OOOO 


SYSINIT 

0256 : 07F4 


SYSSIZE 

OOOO : 108F 


TEMP SEC 

OOOO : 109D 


TEMP^TEK 

OOOO : 2421 


TFORMAT 

OOOO : 1 321 


TICKER 

OOOO : 2431 


TRACKN 

0000:2410 


TTRACK 

OOOO: OFFS 


UP BAT 

OOOO: IF 60 


VECT7201 

OOOO: 1619 


XBAUO 1 

OOOO : 1 62C 


XBAUD2 

OOOO : 2429 


XFRPKT 

OOOO : 0940 


XLT F 

OOOO : 1F04 


XMTCANCEL 

OOOO: 1E04 


XMTMTY 

OOOO : 040E 


XOPTION 

OOOO : 1 6F5 


XRUPT7201 

OOOO: 021 A 


Z90ISR 


Address 


Publics by Value 


0000:0004 

Abs 


0000:0004 


DOS POINTER 

0000:0005 

Abs 

PART SIZE 

OOOO : 0005 


STRATEGY 

0000:0011 


PTRSAVE 

0000:0015 


DEVLST 

0000:0050 


OSKOEV 

0000:006F 


HDSKOEV 

0000:0079 


HDRIVES 

0000:0061 


AUX2DEV 

0000:0093 


DECOISK 

0000:0100 


PHVSDISK 

OOOO: 02 1 A 


Z801SR 

0000:0294 


D0S2OVEC 

0000:0256 


00S21 VEC 

0000:025C 


D0S24VEC 

0OOO:O2A0 


D0S25VEC 

0000:02A4 


D0S26VEC 

0000:02A6 


D0S27VEC 

0000:02AD 


1NT20 

0000:0204 


1NT21 

0000:02FB 


INT24 

0000:0322 


INT25 

0000:0349 


INT26 

0000:0370 


INT27 

0000:0356 


RE INIT 

0000:0400 


R1O0 

OOOO :O40E 


XOPTION 

OOOO :040F 


INITTBL 

0000:0418 


OSKTBL 

0000:0594 


CMDSTR 

0000:0550 


DSKTMR 

OOOO : 05BE 


DSK 

OOOO:O6C0 


MC^FLG 

OOOO :O60E 


hos’ko 

OOOO: 09 2 A 


INI TAB 

0000:0932 


OSK INT 

OOOO : OA1D 


PARTITION 

OOOO :OA35 


ROXLT 

OOOO :OA63 


GETFTNO 

OOOO :OA65 


GETFTN 

OOOO :OA93 


GETPEA 

OOOO : OA9D 


HIOCTL 

OOOO : 0536 


MAXTRK 

0000:0536 


STEPRATE 

OOOO : 0539 


PRECOMP 

0000:0540 


XLT F 

OOOO : 054 1 


HREAO 

OOOO : 0567 


HWRITEV 

0000:0B6E 


HWRITE 

OOOO : OBEE 


HFORMAT 

OOOO : OC34 


HMCHK 

OOOO : OC36 


HVOISK 

OOOO :OC5F 


HINIT 

O000:OCFE 


CLTPN 

0000:0013 


INTHOL 

0000:0095 


HO INIT 

OOOO : OOC8 


OSK INIT 

0000:0000 


HNFMT 


O000:OE7D 
OOOO :OE7E 
OOOO : OFFS 
OOOO : 1080 
OOOO ; 108F 
OOOO : 10E9 
OOOO ; 10F 1 
OOOO : 10F9 
OOOO : 1 105 
OOOO : 1 10B 
OOOO : 1 1C3 
OOOO ; 1 32 1 
OOOO : 1 322 
OOOO ; 1 323 
OOOO : 1 325 
OOOO: 1348 
OOOO : 1 358 
OOOO : 1 359 
OOOO : 13E2 
OOOO : 1 3EF 
OOOO: 13FF 
OOOO ; 1 489 
OOOO: 1513 
OOOO : 1 S9D 
OOOO : 1 5AE 
OOOO : 1 5BF 
OOOO : 1 SDO 
OOOO : 1 SE 1 
OOOO : 1SF2 
OOOO : 1 603 
OOOO : 1 803 
OOOO: 1 605 
OOOO : 1 605 
OOOO: 1613 
OOOO: 1615 
OOOO : 1 62C 
OOOO : 1 630 
OOOO : 1 6E5 
OOOO: 16F5 
OOOO : 1 9C 1 
OOOO : 1 C62 
OOOO : 1 CA4 
OOOO : 1CB5 
OOOO : 1 COS 
OOOO: ICE 6 
OOOO: 1CFD 
OOOO : 1 D 1 1 
OOOO: 1045 
OOOO: 1092 
OOOO: 1050 
OOOO: 10E2 
OOOO: 10EC 
OOOO: 1E33 
OOOO: IE 60 
OOOO: 1E7B 
OOOO: 1E6E 
OOOO: 1EA7 
OOOO : 1 ECA 
OOOO: 1ED4 
OOOO: 1F04 
OOOO : 1 F 1 5 
OOOO: 1F60 


NDRV 
RHONE 
UP BAT 
TEMP__TRK 
TEMP SEC 
AUX2~ 

PRN 

AUX 

CLK 

CON 

FASTCON 
TICKER 
CLK 60_50 
CLK”i 6_20 
clk““ad J 
clkTsr 

INTRET 

OUTHEX 

PSTR 

HVECTOR 

PCCOM 

PCPRT 

PCXCOM 

DFLTCOM 

DFLTPRT 

DFLTXCOM 

NVMCOM 

NVMPRT 

NVMXCOH 

OATBCOM 

DATBPRT 

PRTVPRT 

PRTYCOM 

PRTBAUD 

XBAUD1 

XBAUD2 

RDNVMCOM 

RUPT7201 

XRUPT7201 

PRG7201 

DFLT7201 

OFLTBUF 

RDSETUP 

RCVENA 

RCVDIS 

INSTAT 

INCHAR 

GETCHAR 

OUTSTAT 

OUTCHAR 

PUTCHAR 

OUTNOW 

RDMODEM 

SETMOOEM 

BRKON 

BRKOFF 

RCVINT 

RCVCANCEL 

XMTMTY 

XM7CANCEL 

HACK7201 

VECT7201 


0000: 1P8D 

STATCHC 

OOOO: 1PB0 

STCANCEL 

OOOO: 1FBA 

INITCOM 

0000:2036 

BUFFER 

0000:2238 

BIOS IN IT 

OOOO : 2236 

ENOBIOS 

0000:2410 

PACKET BASE 

OOOO: 2410 

ttrack” 

OOOO : 2421 

TFORMAT 

0000:2429 

XFRPKT 

0000:2429 

PACKET ADR 

0000:2426 

I66PKT“ 

OOOO : 2420 

FNCCOD 

OOOO : 2420 

PACKET 

OOOO: 242E 

STATUS 

OOOO : 242F 

DRVNO 

OOOO : 2430 

SECNO 

OOOO: 2431 

TRACKN 

OOOO : 2432 

NSECT 

OOOO : 2433 

DMAAOR 

OOOO : 2435 

EXSTAT 

OOOO : 2446 

lOINIT 

0256:0000 

SYSINIT 

0256 : 0005 

CURRENT DOS LOCATION 

0256 : 0009 

FINAL DOS LOCATION 

0256 : 0006 

DEVICE LIST 

0256 :OOOF 

memory'^size 

0256 ; 001 1 

DEFAULT DRIVE 

0256:0012 

buffers” 

0256:0013 

FILES 

0256 : 0766 

badopm 

0256 :07AA 

CRLFM 

0256 : 07AD 

BADS I 2 

0256 : 07CE 

6A0L0 

0256 : 07E0 

6A0C0M 

0256 : 07F4 

SYSS IZE 
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cgroup group code 
biosseg equ 40h 

Top level I/O system module: contains the 

device tables for the minimum system. 

public St rat egy ,ptrsave,dev1st .hdsKdev, dos__po inter .hdrives 
public dsKdev . aux2dev 

extrn b i os i n i t : near 

extrn CON : NEAR , AU X : NEAR , PRN : NEAR , AUX2;NEAR 
extrn c 1 k : near . dsK : near 
extrn dsk int:near 
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02-20-64 


RAGE 


1-2 


26 




page 


27 

OOOO 



code segment 

byte public 'cede' 

26 




assume cs : cgr oup . ds : cgroup 

29 




; 


30 




: Initialize 

ourselves end what's necessary 

31 




:SYSIN1T, then pass control there. 

32 




; 


33 

OOOO 

FA 


i n i t : c 1 i 


34 

O001 

E9 OOOO E 


Jmp 

biosinit 

35 





36 

0004 

OOOO 


dos pointer 

dw O ;Fi11ed in 

37 






36 

39 




;Simp1 ist ic 

Strategy routine for 2.00. 

40 

4 1 

0006 



stratg proc 

far 

42 

0006 



St rat egy : 


43 

0006 

2E: 69 IE 

001 1 R 

mov 

word ptr cs : pt r save , bx 

44 

0006 

2E: 6C 06 

0013 R 

mov 

word ptr cs : pt r save+2 , es 

45 

O010 

CB 


ret 

47 

46 

O01 1 



stratg endp 


49 




;Pub1ic pointer save. 

5 1 

001 1 



ptrsave dd 

(7) 
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52 

53 

54 

55 

56 

57 
56 

59 

60 
61 
62 

63 

64 

65 

66 
67 
66 

69 

70 

71 

72 

73 

74 

75 

76 

77 
76 
79 
60 
6 1 
62 

63 

64 

85 

86 
67 
66 
69 
90 
9 1 

92 

93 

94 

95 

96 

97 
96 
99 

too 

101 

102 

103 

104 

105 

106 


0015 

0015 0027 R 0040 

0019 6003 
O01B 0006 R 
O01D OOOO E 

O01F 43 4F 4E 20 20 20 
20 20 

0027 

0027 0039 R 0040 

0026 COOO 

0020 0006 R 

002F OOOO E 

0031 41 55 56 20 20 20 

20 20 

0039 

0039 0046 R 0040 

0030 COOO 

003F 0006 R 

0041 OOOO E 

0043 50 52 4E 20 20 20 


page 

;l/0 device table. This contains the five 
;minimum devices: CON. AUX, PRN . CLOCK and 

;disHs. SYSINIT may load others later, but 
,'that's no concern to us here. 


DWORD pointer to next device 
(-1,-1 if last device) 



Dev ice 

attribute WORD 



Bit 15 = 1 for chacter devices. 




O for Block devices. 



Charcter devices. (Bit 15=1) 



Bit 

0*1 current st i device. 



Bit 

1 * 1 current st o device. 



Bit 

2*1 current NUL device. 



Bit 

3*1 current Clock device. 



Bit 

14 = 1 lOCTL control bit. 







Dev ice 

strategy pointer. 

; 






Oev ice 

interrupt pointer. 







Dev ice 

name f i e 1 d . 



Character devices are any valid name 



left justified, in a space filled 



field. 



Block 

devices contain # of units in 



t he 

first byte. 





* 

dev 1 St 

1 abe 1 

word 


condev 

: dw 

auxdev , b i osseg ; pt r to next 



dw 

6003h ;char,sti,st 

o 


dw 

strategy 



dw 

con 



db 

' CON 


auxdev 





dw 

prndev , bi osseg 



dw 

OCOOOh 



dw 

St rategy 



dw 

aux 



db 

'AUX 


pr ndev 





dw 

c IKdev . bi osseg 



dw 

OCOOOh 



dw 

st rategy 



dw 

pr n 



db 

' PRN 
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107 


20 20 





10S 

0040 




c Ikdev ; 


10S 

0040 

0050 R 0040 




dw 

110 

004P 

6006 




dw 

1 1 1 

0051 

0006 R 




dw 

112 

0013 

OOOO E 




dw 

113 

0055 

43 4C 4F 43 

40 

20 


db 

114 


20 20 





111 

0050 




dskdev : 


1 1 1 

0050 

FFFF FFFF 




dw 

117 

0061 

2000 




dw 

111 

0063 

0006 R 




dw 

111 

0095 

OOOO E 




dw 

120 

0067 

02 OO OO 00 

OO 

OO 


db 

121 


00 OO 





122 







123 

006P 




hdskdev 


124 

006P 





dw 

121 

0073 

6000 




dw 

126 

0075 

0006 R 




dw 

127 

0077 

OOOO E 




dw 

126 

0079 

01 OO OO OO 

OO 

OO 

hdr i ves 

db 

129 


00 OO 





130 







131 

0061 




aux2dev 


132 

0061 

FFFF FFFF 




DW 

133 

0065 

cooo 




DW 

134 

0067 

0006 R 




DW 

135 

0069 

OOOO E 




DW 

136 

0060 

41 55 56 32 

20 

20 


DO 

137 


20 20 





138 







139 

0093 




code ends 

140 







141 






end 


dsHd«v , biossag 

AbOSh 

strategy 

elk 

'CLOCK 


- 1,-1 

2OO0H ;non-IBM compatable without lOCTL 

strategy 

dsk 

2 . 0 . 0 , 0 . 0 , 0 . 0.0 


- 1,-1 

eoooh ; with lOCTL 

Strategy 

dsk^int 

1 , o7o , o , o . o , o , o 


- 1,-1 

OCOOOH 

Strategy 

aux2 

'AUX2 ; device name 
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PAGE 

Symbols- ‘ 

Segments and groups: 








N 

a 

m e 

S i ze 

align 

comb i ne 

class 

CGRDUP .... 




GROUP 




CDDE .... 




0093 

BYTE 

PUBLIC 

'CODE ' 

Symbols : 










N 

a 

m e 

Type 

Value 

Att r 


AUX 




L 

NEAR 

OOOO 


Ext erne 1 

AUX2 




L 

NEAR 

OOOO 


Ext erne 1 

AUX2DEV. . . . 




L 

NEAR 

008 1 

CODE 

G 1 oba 1 

AUXDEV .... 




L 

NEAR 

0027 

CODE 


5I0SINIT . . . 




L 

NEAR 

OOOO 


Ext erne 1 

6I0SSEG. . . . 




Number 

0040 



CLK 




L 

NEAR 

OOOO 


Ext erne 1 

CLKDEV . . . . 




L 

NEAR 

004B 

CODE 


CON 




L 

NEAR 

OOOO 


Ext er na 1 

CONDEV . . . . 




L 

NEAR 

0015 

CODE 


DE-VtST . . . . 




L 

WORD 

0015 

CODE 

G 1 oba 1 

DOS POINTER. . 




L 

WORD 

0004 

CODE 

G 1 oba 1 

dskT 




L 

NEAR 

OOOO 


Ext erna 1 

DSKDEV . . . . 




L 

NEAR 

0050 

CODE 

Global 

DSK INT. . . . 




L 

NEAR 

OOOO 


Ext erna 1 

hdrTves. . . . 




L 

OYTE 

0079 

CODE 

Global 

HDSKDEV. . . . 




L 

NEAR 

006F 

CODE 

Global 

INIT 




L 

NEAR 

OOOO 

CODE 


PRN 




L 

NEAR 

OOOO 


Ext erna 1 

PRNDEV . . . . 




L 

NEAR 

0039 

CODE 


PTRSAVE. . . . 




L 

DWORD 

001 1 

CODE 

Global 

STRATEGY . . . 




L 

NEAR 

0006 

CODE 

Global 

STRATG . . . . 




F 

PROC 

0006 

CODE 

Length 


Warning Severe 
Errors Errors 




Symbol Cross Roforonco 


(# is definition) 


Crof • 1 


AUX 22# •• 

AUX2 22# 136 

AUX20IV It 131# 

AUXDEV 66 64# 

■ lOSINIT 21# 34 

BIOSSEG 13# 64 66 102 109 

CCROUP 1 1 28 24 

CLK 23# 112 

CLKOeV 102 108# 

CODE 11 27# 27 139 

CON 22# 9 1 

CONOEV 88# 

DEVLST 18 87# 

DOS_#OINTER 18 36# 

DSK’’ 23# 119 

DSKDEV 19 109 116# 

DSK^INT 24# 127 

HDItIVES 18 128# 

HDSKOEV 18 123# 

INIT 33# 

PRN 22# 106 

PRNOEV 96 101# 

PTRSAVE 18 43 44 51# 

STRATEGY 18 42# 90 97 104 111 118 126 134 

STRATC 40# 47 
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TITLE DEC Rainbow Rx-5O/Z60 disk driver 
NAME DECOISK 

COMPANY CONFIDENTIAL 

Copyright (C) 1983 Digital Equipment Corporation 

All rights reserved. 


cgroup group code 

Converts the standard BIOS data packet to 
the Rainbow Z80 packet and executes it . 
Returns normal MSOOS error codes. 


pub 1 i c 
ext rn 


deed i sk . z80 i sr , phy sd i sk 
buffer :word, MC FLC-.BYTE 


Z80 function codes: 


13h 
14h 
I5h 
1 6h 
23h 
24h 


21 



; 


22 

« 

0013 

OKRDCOM 

equ 

23 

S 

0014 

OKWTCOM 

equ 

24 

s 

0015 

OKCMCOM 

equ 

26 

t 

0016 

OKWVFCON 

1 equ 

26 

t 

0023 

OKVFYCOM 

1 equ 

27 

s 

0024 

OKFMTCOM 

1 equ 

26 





29 

s 

OOOO 

i nt z80 

equ 

30 

c 

0002 

gser 

equ 

31 





32 

s 

0000 

XCOMMAND 

EOU 

33 

s 

0001 

XDRIVE 

EOU 

34 

s 

0002 

XSECTOR 

EOU 

36 

c 

0003 

XPHDRV 

EOU 

36 

s 

0004 

XTRACK 

EOU 

37 

s 

0006 

XCOUNT 

EOU 

38 

s 

0008 

XDMAOFF 

EOU 

39 

X 

OOOA 

XDMASEG 

EOU 

40 





41 





42 

X 

OOOO 

rx50 

EOU 

43 

X 

0008 

i bma 

EOU 

44 

X 

0002 

ibmS 

EOU 

45 





46 

X 

OOOO 

rx50va 1 

equ 

47 

X 

0001 

i bmBva 1 

equ 

48 

X 

0002 

i bm9va 1 

equ 


OOh 

08h 

02h 

OOh 

Olh 

02h 


;disk read, 

; d i sk wr i t e , 

; media check, 

;write with verify, 

; verify disk command 
; format track/disk command 

; z80 interrupt port, 

; interrupt status port, 

lOCTL PACKET COMMAND OFFSET 
DRIVE/SIDE OFFSET 
SECTOR OFFSET 
PHYSICAL DRIVE CODE 
TRACK # TO USE 
# OF SECTORS TO XFER 
OFFSET OF DMA XFER 
SEGMENT OF DMA XFER 


;return value for RX50 disks. 

;media check return value for IBM I 
:raediacheck return value for IBM 9 

;MSDOS value for rx50 disks 
;IBM 8 sector disks 
.'IBM 9 sector disks 


sect or 
sector 


include iodef.ash 
Rainbow Interrupt numbers. 

1- Apr >83 sgs added dskio i nt vector 

19-Mar-83 sgs added profile int vector {user clocK] 

the int profile is called by the RTC interrupt service for each tick. 
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RAGE 


1-2 


56 

57 

sa s ooaa 

sa « 002 C 

•O s OOS5 

a 1 
82 

83 

84 

85 
66 

67 

68 

89 * 0040 

70 * 0041 

71 c 0042 

72 s 0043 

73 I 0044 

74 s 0045 

75 t 0046 

76 * 0047 

77 t 0018 

78 

79 

80 

81 s 0010 

82 s 0011 

83 s 0040 

84 t 0041 

85 s 0042 

86 s 0043 

87 

88 

89 

90 * 0001 

9 1 : 0002 

92 

93 

94 

95 

96 t OOOO 

97 s OO01 

98 = 0002 

99 : 0003 

100 e 0004 

101 : 0005 

102 : 0006 

103 > 0007 

104 : 0008 

105 : 0009 

106 = OOOA 

107 s OOOC 

108 s OOOE 

109 = 0010 

110 *0012 
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C 

C 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 


;The ax and ds register don't need to be saved {done in clkisrl. 

profile equ 64h ;lOO. user interface to clock interrupt 

c1k_int equ 2ch ;60Hz i nt , 

dskio equ 65h ;direct disk io for format 

;17-Mar-83 sgs changed to include int 20-26 

; interrupt 22-24h are duplicated at 42-44h for consistency. 

: These are the relocated Rainbow interrupts. 

; interrupts, 20h-26h moved to 40h-46h 

;ATTENTION Modules lOINIT and REINIT may have to be 

;changed if int vectors 40h to 46h are changed 

vert equ 40h ; new vert. freq. 

spare41 equ 41h 

spare42 equ 42h 

comdraa equ 43h ; DMA Ctrl opt i ona 1 comm, board 

aux_prn equ 44h ;7201 comm . /pr i nt er 

excom equ 45h ;extented comm, option 

uart equ 46h ; new UART vector, 

z80 equ 47h ; Z80 interrupt, 

rom equ 18h ; new ROM access, 

;OEC Rainbow ID port stuff. 

kdp equ lOh ;8251 data port, 

ksp equ 11h ;8251 status, 

auxdp equ 40h ;7201 data, 

prndp equ 41h 

auxp equ 42h ;7201 command, 

prnp equ 43h 

i Values in XOPTION 

wprsnt equ 01 ;Winnie preset 

xcprsnt equ 02 ; XCOMM present 

i nc 1 ude disk. ash 

;Physica1 disk ID data packet. 

command equ O ;read or write, 

drive equ 1 ;phs. drive, 

track equ 2 ;track, 

sector equ 3 ; starting sector, 

count equ 4 ; sector count, 

curtrk equ 5 ;current track, 

dens i t y equ 6 ; N . A . 

gap 1 en equ 7 ; N . A . 

enn equ 8 ; N . A . 

dt 1 equ 9 ; N . A . 

secsiz equ 10 ;sector size, 

dmaoff equ 12 ; DMA offset, 

dmaseg equ 14 ; DMA segment 

spt equ 16 ; sect or s/t rack 

head equ 18 ;head. 
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1 1 1 
1 1 2 
1 1 3 
1 1 4 

1 1 5 OOOO 

1 1 6 OOOO 
1 1 7 

1 1 8 
1 1 9 
1 20 
1 2 1 
122 
123 
1 24 
1 25 
126 
1 27 
1 28 
1 29 
1 30 
131 
1 32 
1 33 
1 34 
1 35 
136 
1 37 
1 38 


page 

;This is what the 280 thinks memory looks like. 

z80seg segment at O 
z80seg ends 

extrn packet__adr : near 

extrn tformat:byte ;Tab1e for current formats, one byte per drive, 

extrn ttrackibyte ;Current tracks, one per drive. As in TFORMAT, 

;Pointers to the Z80 and 8088 packets. 

extrn xfrpkt:word ;pointer to "packet" 

extrn i88pkt:word ;returned pointer from Z80 

;The packet for the z80. 


extrn packet :byte 
extrn fnccod:byte 
extrn status:byte 
extrn drvno:byte 
extrn secno;byte 
extrn tracknrbyte 
extrn nsectrbyte 
extrn dmaadr:word 
extrn exstat:byte 


;Z80 packet pointers 
; F unct i on code 
;retnd status, 

; dr i ve and s i de . 

; sect or # 

; t r ack # 

;# of sectors to process 
: DMA address (abs) 
;extended status 
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PACE 


1-4 


139 

140 

141 

142 

143 

144 
149 

148 
1 47 
146 

149 
1 50 
1 5 1 

152 

153 

154 

155 
158 

157 

158 

159 
1 60 
161 
1 62 
1 63 
1 64 
1 65 
168 
1 67 
1 68 
1 69 
1 70 
1 7 1 
1 72 

173 

174 
1 75 
1 76 
1 77 
1 78 
179 
1 60 
1 8 1 
1 62 
1 83 
1 64 
1 85 
166 
1 87 
1 88 
189 
1 90 
1 9 1 

192 

193 


The 

DEC 


194 

195 

196 

197 

1 98 

199 

200 
201 
202 

203 

204 

205 

206 

207 

208 
209 

2 10 


OOOO 


0000 06 

0001 58 R 

0004 8E CO 


page 


code segment byte public 'code' 
assume cs : cgroup. ds : c group , es : xSOseg 


Convert the BIOS packet for the 280. make the 
request . The absolute address range must be 
1000 - ffff hex, as below that is 280 private, 
and the 280 cannot reach above it. A special 
'disk' module is requred. 


decdisk:push es 

mov ax.seg x80sag 

mov es.ax 


0006 32 02 

0008 8A 57 01 
0005 DO E2 
OOOD DO E2 
OOOF DO E2 
001 1 DO E2 

0013 26: 88 16 OOOO E 


0018 

001 B 
OO 1 F 

002 1 
0025 


8A 47 
80 7F 
75 OE 
80 7F 
72 08 


03 

06 OO 
02 02 


xor 
mov 
sh 1 
sh 1 
sh 1 
sh 1 
mov 


d1 ,d1 

d1 , dr i ve { bx ] 

01.1 

dl . 1 

d1 . 1 

dl . 1 

es : dr vno , d 1 


;clear drive byte 8 assume single side 
: make drive 
: se 1 ect bits. 

: SHL OL . 1 
: 4 t i mes i s 
;much faster 


Dniy if the media is RX-50, and the track is 
above 1. skew the sector. RX-50 media tracks 
O and 1 are the boot, and non-RX-50 media 
is assumed to be IBM. 

mov a 1 . sect or [ bx ] 

cmp byte pt r dens i t y I bx ] . 0 

jne xwO : i f RX - 50 . 

cmp byte ptr track[bx},2 

j b xwO ; and t r k 2 - , 


0027 54 OO 

0029 85 FO 

002B 8A 84 01EE R 


mov 

mov 

mov 


ah , O 
s i . ax 

a 1 . skewt b1__2 I si 


: skew it. Sis 
; i ndex to t b 1 


002F 26: A2 OOOO E 

0033 8A 47 02 
0036 26: A2 OOOO E 

003A 8A 47 04 
003D 26: A2 OOOO E 


mov 

mov 

mov 

mov 

mov 


es:secno,a1 ; set it 

a 1 . t rack i bx ] 
es : t r ackn . a 1 
a 1 . count [ bx ] 
es : nsect , a 1 


004 1 
0044 
0046 
0048 
004A 
004C 
004F 


8B 

D 1 
D 1 
D 1 
D 1 
03 
26 


47 OE 

EO 

EO 

EO 

EO 

47 OC 
A3 OOOO 


Make the absolute address in AX. Ignore out of 
bounds addresses; DISK is supposed to process 
them for us. 


mov 
sh 1 
sh 1 
sh 1 
sh 1 
add 
mov 


ax , dmaseg [ bx ) 
ax . 1 
ax . 1 
ax . 1 
ax . 1 

ax . dmaof f [ bx 1 
es : dmaadr , ax 


segment 
times 2 . 
t i mes 4 . 
times 8 . 
t i mes 1 6 , 
plus offset 
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0053 8A 07 

0055 98 

0056 8B FO 

0058 8A 84 0085 R 
005C 26: A2 OOOO E 


0060 E8 019C R 

0063 07 

0064 C3 


0065 14 13 15 16 


mov a 1 , command I bx ] 

cbw 

mov s i , ax 

mov a 1 , xdskf cn I s i ] 

mov es:fnccod,a1 

Execute the packet. 

call exec x80 

pop es 

ret 


; what to do? 

; expand t o wor d 
;copy command 
; get actual command 
; store Z80 command 


; Invoke 280 and report error if any 


;trans1ate table for internal command to 280 command 


xdsKfcn db qkwtcom, qkrdcom, qkcmcom, qkwvfcom 
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PACE 


1-6 


21 1 
212 

213 

214 

215 

216 

217 

218 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 

250 
25 1 

252 

253 

254 

255 

256 

257 

258 

259 

260 
261 
262 

263 

264 

265 


The 

DEC 


266 

267 

268 

269 

270 
27 1 

272 

273 

274 

275 

276 

277 

278 

279 

280 
281 
282 

283 

284 

285 

286 

287 

288 

289 

290 
29 1 

292 

293 

294 

295 

296 

297 

298 

299 

300 

301 

302 

303 

304 

305 

306 

307 

308 

309 
3 10 
31 1 

312 

313 

314 

315 

316 

317 

318 

319 

320 


04 I 


for use by format, direct disk i/o 
same as decdisk. 


4 dup (O) .'this space maker needed for exe2bin 1 -Apr -83 sgs no joke 


check media function switch 

COMMAND : 6 then turn the function ON 

COMMAND s 7 then turn the function OFF 

COMMAND c 8 then read the function status in AL 


0060 




0060 




0060 

8A 

07 


006F 

3C 

06 


007 1 

72 

1 A 


0073 

IE 



0074 

OE 



0075 

IF 



0076 

B4 

OO 


0078 

74 

06 


007A 

FE 

C4 


007C 

3C 

07 


007E 

75 

04 


0080 

88 

26 

OOOO 

0084 

33 

CO 


0086 

AO 

OOOO E 

0089 

1 F 



008A 

CA 

0002 

0080 




0080 

53 



008E 

06 



008F 

B8 


R 

0092 

8E 

CO 


0094 

32 

02 


0096 

8A 

57 

oi 

0099 

80 

FA 

FF 

009C 

75 

06 


009E 

8A 

57 

03 

OOA 1 

EB 

09 

90 

OOA4 

DO 

E2 


OOA6 

DO 

E2 


OOA8 

DO 

E2 


OOAA 

DO 

E2 



physdisk label near 
physdiski proc far 


PHYS2 ; 
PHYS3 : 


MOV 

CMP 

JB 

PUSH 

PUSH 

POP 

MOV 

JZ 

INC 

CMP 

JNZ 

MOV 

XOR 

MOV 

POP 

RET 

push 

push 


AL . XCOMMANOIBX) 

AL , 6 
PHYS 1 
OS 
CS 
OS 

AH , O 

PHYS2 

AH 

AL . 7 
PHYS3 

BYTE PTR MC_FLG.AH 
AX , AX 

AL.BYTE PTR MC FLG 
OS “ 


bx 

es 


; get command 
: check media function? 

; save user's OS 

; DSsCS 

; assume turn function on 

: assume turn function off 
if > 8 then do as 8 


ds set to calling segment for [bx] param. 


mov 

mov 

xor 
mov 
cmp 
ini 
mov 
jmp 
sh 1 

Shi 

sh 1 
sh 1 


ax.seg z80seg 
es . ax 

d 1 , d 1 

d 1 . xdr i ve [ bx ] 
d1 , Of fh 
1 ogdrv 

d 1 , xphdrv [ bx ] 

stdr V 

d1 , 1 

dl . 1 

dl . 1 

dl , 1 


;make drive 

;is this a physical disk oper? 

; no. its logical 

; get user's pre defined drive code 

;e1se set the drive 

;move drive F to high nybble 

: SHL DL , 1 

; 4 t i mes i s 

;much faster 
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OOAC 

26 

88 16 OOOO E 

St drv : 

mov 

es : drvno . dl 

OOB 1 

86 

4F 04 


mov 

cx , xt rack [ bx ] 

OOB4 

33 

CO 


xor 

ax . ax 

OOB6 

8A 

47 02 


mov 

a 1 , xsect or ( bx ] 

OOB9 

83 

F9 02 


cmp 

cx , 02 

OOBC 

72 

07 


jb 

skwed 

OOBE 

8B 

FO 


mov 

s i , ax 

OOCO 

2E 

8A 84 01EE R 


mov 

a 1 , cs : skewt b1__ 

OOC5 

26 

88 OE OOOO E 

skwed : 

mov 

es : t r ackn . c 1 

OOCA 

26 

A2 OOOO E 


mov 

es : secno , a 1 

OOCE 

26 

C6 06 OOOO E 

01 

mov 

byte ptr es : ns 

0004 

32 

E4 


xor 

ah , ah 

0006 

8A 

07 


mov 

a 1 , xc ommand [ bx 

0008 

8B 

FO 


mov 

s i , ax 

OODA 

3C 

OO 


cmp 

a1 .0 

OODC 

74 

22 



r edf nd 1 

OODE 

8B 

4F OA 


mov 

cx . xdmaseg[ bx ] 

OOE 1 

8B 

47 08 


mov 

ax , xdmaof f [ bx ] 

OOE4 

83 

FE 03 


cmp 

si . 03 

OOE7 

74 

1C 


j* 

fmt f ndl 

00E9 

56 


mov 1 St : 

push 

si 

OOEA 

57 



push 

d i 

OOEB 

IE 



push 

ds 

OOEC 

06 



push 

es 

OOED 

FC 



c Id 


OOEE 

OE 



push 

cs 

OOEF 

07 



pop 

es 

OOFO 

BF 

OOOO E 


mov 

d i .off set buf f < 

OOF3 

8E 

09 


mov 

ds , cx 

OOF5 

8B 

FO 


mov 

s i , ax 

OOF7 

B9 

0100 


mov 

cx , 1 OOh 

OOFA 

F3/ A5 


rep 

movsw 

OOFC 

07 



pop 

os 

OOFO 

1 F 



pop 

ds 

OOFE 

5F 



pop 

d i 

OOFF 

5E 



pop 

S i 

0 100 



r edf nd 1 



0100 

6C 

C9 


mov 

CX . cs 

0102 

B8 

OOOO E 


mov 

ax , offset buf f ( 

0 105 



fmtf ndl 



OIOS 

0 1 

El 


sh 1 

cx , 1 

0107 

D 1 

E 1 


Shi 

cx, 1 

0109 

0 1 

El 


sh 1 

cx , 1 

010B 

01 

El 


Shi 

cx , 1 

010D 

03 

C8 


add 

cx , ax 

010F 

26 ; 

89 OE OOOO E 


mov 

es : dmaadr . cx 

0114 

2E 

8A 84 017F R 


mov 

a 1 , byt e ptr cs 

0119 

26 

A2 OOOO E 


mov 

es : f nccod , a 1 


; put drive/side in packet 
; get track # 

; c 1 ear high byt e 
: get sect or # 

;is track # > 2 
: i f not , dont skew 
;e1se index into skew table 
[si] ; and get skewed value 
; save track F 
;save processed sector 


clear high byte 
what to do? 

index into function table 

if read, use intermediate buffer and move later 

get users data buffer pt r 
it is. after all, a dword type 
are we doing a format? 
then use the users buffer 

save the registers we are going to cream 
in the block move 


;make sure we are going in the right direction 
; destination is our segment 

;and the default buffer 
and the source is the users buffer 

move full sector 


;restore registers 


;make absolute address 
;and put it in the packet 


icdskfcnCsi] ; get function code 

; put code in packet 


0110 IE 


now set ds to cs for local code 
2 w 1 : push ds 
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PACE 


1 -8 


321 

01 IE 

8C 

C8 

mev 

ax , cs 


322 

0120 

8E 

D8 

fflOV 

ds , ax 

set ds 

323 

0122 

82 


push 

dx 

save drive # 

324 

0123 

86 


push 

si 

get function code 

32S 

0124 

E6 

019C R 

call 

exec z80 

Invoke 280 and wait for status 

32C 

0127 

8A 


pop 

dx 

recover function code 

327 

0128 

BE 


pop 

si 

recover drive # 

328 

0128 

8C 


pushf 


save flags around grand munging we do 

328 

012A 

83 

FA 04 

crop 

dx. 04 

was this a media check? 

330 

012D 

78 

2A 

jni 

eggs i t 

if not. just bail out 

331 

012F 

81 

04 

raov 

c 1 . 4 

restore drive value 

332 

0131 

D3 

CE 

r or 

S i , c 1 

to its virgin state 

333 

0133 

81 

E6 OOOF 

and 

si . Of h 

JIC any garbage 

334 

0137 

26 

8A A4 OOOO E 

roov 

ah,es:byte ptr ti 

Format [si] ; get media type 

338 

013C 

80 

FC OO 

crop 

ah . 0 

is this an RX80? 

338 

013F 

74 

OC 

j» 

f mt sot 

just put 0 in buffer 

337 

0141 

80 

FC 08 

crop 

ah , i bm8 

Is this an I 8M 8 sector 

338 

0144 

78 

OS 

jna 

ot er f mt 

no. must be an ISM 9 

338 

0146 

84 

01 

roov 

ah , i bm8va 1 

save MSOOS code 

340 

0148 

E8 

03 90 

jmp 

f mt set 

for users 

341 

0148 

84 

02 

ot er f rot : roov 

ah , i bro9 va 1 

assume ISM 9 sector for now 

342 

014D 

26 

88 IE OOOO E 

f rot set : mov 

bx.es: dmaadr 

get pointer to xfer buffer 

343 

0182 

26 

88 27 

roov 

es : [ bx ] .ah 

Save media type in buffer 

344 

0188 

33 

D2 

xor 

dx . dx 

do move the buffer, but 

348 

0187 

33 

CO 

xor 

ax . ax 

dont return a funny status 

346 

0188 



eggs i t : 


347 

0188 

8D 


popf 



348 

018A 

IF 


pop 

ds 


348 

0188 

07 


pop 

es 


380 

Oise 

88 


pop 

bx ; rest ore 

users request buffer 

381 

01SD 

8C 


pushf 

: save flags again I 

382 

OISE 

80 

3F OO 

crop 

byte ptr xc ommand [ bx ] , 0 ;was this a read? 1 

383 

018 1 

78 

18 

jna 

out here 


384 






388 

0163 

IE 


push 

ds 


388 

0164 

06 


push 

es 


387 

0188 

86 


push 

si 


388 

0166 

87 


push 

d i 


388 

0167 

8E 

4 7 OA 

mov 

es . xdmaseg [ bx ] ; put data where the user expects to see it 1 

380 

01 6A 

88 

7F 08 

roov 

d i , xdmaof f [ bx ] 


381 

016D 

OE 


push 

cs 


382 

01 6E 

IF 


pop 

ds 


363 

01 6F 

8E 

OOOO E 

mov 

si, offset buffer 


364 

0172 

89 

0100 

mov 

cx , 1 OOh 


388 

0178 

F3/ AS 

rep 

movsw 


366 

0177 

SF 


pop 

d i 


367 

0178 

SE 


pop 

S i 


388 

0178 

07 


pop 

es 


368 

01 7A 

1 F 


pop 

ds 


370 







371 

0178 



out here: 



372 

0178 

9D 


popf 

; r et ur n f 1 ags 1 

373 

017C 

CA 

0002 

r ot 

2 :ca11ed with INT (clean stack) 1 

374 







378 

017F 

13 


XOSKFCN; db 

OKRDCDM 
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376 

0180 

1 4 


db 

OKWTCOM 


377 

0181 

1 6 


db 

OKWVFCOM 


378 

0182 

24 


db 

OKFMTCOM 


378 

0183 

18 


db 

OKCMCOM 


380 

O 184 

23 


db 

OKVFYCOM 


381 

0188 



physciiski endp 
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382 

383 

384 

385 

386 

387 

388 

389 

390 
39 1 

392 

393 

394 

395 

396 

397 

398 

399 

400 

401 

402 

403 

404 

405 

406 

407 

408 

409 
4 10 
4 1 1 
4 1 2 
4 1 3 
4 1 4 
415 
4 1 6 
4 1 7 
4 1 8 
4 1 9 
420 

42 1 

422 

423 

424 

425 

426 

427 

428 

429 

430 

43 1 

432 

433 

434 

435 

436 


The 
DEC I 


437 

438 

439 

440 

44 1 

442 

443 

444 

445 

446 

447 

448 

449 

450 

45 1 

452 

453 


page 

Interrupt service from the Z80. The Z80 
indicates it is done by setting Z80PKT = = 
I88PKT, and interrupting us. Once we clear 
our interrupt, it then zeros the packet 





po i nt er 

. The 

reason for all this interlocking 




po i nt er 

fiddling is a mystery. 

0185 

OOOO 


ipkt 

dw 

0 

0187 

50 

280 i sr : 

push 

ax 

0188 

06 



push 

es 

0189 

B8 R 



mov 

ax.seg z80seg ;if the ptr is 

01 8C 

8E CO 



mov 

es.ax ;0, do nothing. 

01 8E 

26: 87 06 OOOO E 



xchg 

ax,es:xfrpkt ; see if packet back 

0193 

2E: A3 0185 R 



mov 

cs:zpkt.ax ;if zppkt still 0, 

0197 

E4 00 

2 i 1 : 

i n 

al,intz80 ;clear the i nt . 

0199 

07 



pop 

es 

01 9A 

58 



pop 

ax 

019B 

CF 



i r et 





As in the ISR 

we must play strange games with 




packet 

pointers. Set the i88 packet pointer. 




interrupt the 

280. when it clears it's i nt - 




err upt , 

zero 

the packet pointer, then wait 




for an 

interrupt from the 280. 


upper level not back 


01 9C 
01 9C 
01 A3 
01 AA 
01 BO 


01 B2 
01 B8 


01 BA 
01 BB 
01 C 1 
01 C3 
01 C4 
01 C5 

01 C7 
01 C8 
01 CC 
01 CE 
O 1 DO 
010 1 


26 
2E 
26 
E6 OO 


C7 06 OOOO E OOOO E 

C7 06 0185 R OOOO 

C6 06 OOOO E OO 


exec z80 : 

mov es : xf r pkt , of f set zBOseg : packet ; set xfer packet ready 

mov cs:zpkt,0 ; set status to gone 

mov es:byte pt r status, O 

out intz80,a1 .start z80. 

Wait until the 280 accepts the interrupt, 
then zero the packet pointer. 


26: 83 3E OOOO E 

75 F8 


cmp 

jnz 


word ptr esrxfrpkt.O 
xzO 


FA 
2E ; 


83 3E 0185 R 00 


;Wait for the 280 to interrupt us. 
xz 1 


75 04 

FB 

F4 

EB F3 


FB 
26 ; 


AO OOOO E 


3C 00 
75 02 
F8 
C3 


c 1 i 
cmp 
jne 

St i 
hit 
jmp 

St i 

mov 
cmp 
jnz 
c 1 c 
r et 


c s : zpkt , O 
xz2 


a 1 , es : St at us 
a 1 , O 
xz80er r 


; 1 ock out Z80 , 
: see i f gone 
; done . 

; wa it for an 
; i nt errupt . 


; i f no error , 

;make sure carry bit clear 
; and return 
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01 D2 

01D2 BE OOOO 

O 1 D5 26 ; AO OOOO E 

01D9 3C OO 

01DB 75 04 

01DD BO OC 

01DF EB OB 


xzSOer r : 

mov s i , O 

mov al,es;exstat 

cmp a 1 , O 

jnz xz4 

mov a 1 , OCh 

jmp short xz5 


; pt r to code , 

; get raw machine status 

;this may be zero if no hardware error 
;return "general failure" 


01E1 DO CO 
01E3 72 03 

01E5 46 

01E6 EB F9 


jc xz3 

i nc Si 

jmp short xz4 


; sh i f t to Cy , 
; next bit . . . 


01E8 8A 84 01F9 R 
OlEC F9 
01ED C3 


xz3 : mov 

xz5 ; Stc 

r et 


a 1 , er r code [ s i ] .get return 
; code , 
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454 


page 




455 







456 



DEC RX-50 sect 

or skew table. 

Only 

457 



used on tracks 

2 to 79 . 

Tracks O and 1 are 

458 



unskewed . 




459 







460 







461 



skew SE 

2 



462 

01EE 

skewtbl 2 label 

byt e 



463 







464 

01 EE 

oo 

db 

O 


; no sect or 0 , 

465 

01 EF 

0 1 

db 

1 



466 

01 FO 

03 

db 

3 



467 

OIF 1 

06 

db 

5 



468 

01 F2 

07 

db 

7 



469 

01 F3 

09 

db 

9 



470 

01 F4 

02 

db 

2 



47 1 

01FS 

04 

db 

4 



472 

01 F6 

06 

db 

6 



473 

01 F7 

08 

db 

8 



474 

01F8 

OA 

db 

10 



475 







476 



179x -> MSDOS 

disk error code 

translate table. 

477 







478 

01 F9 

errcode label byte 



479 







480 

01 F9 

02 

db 

2 

bit 7 

not ready, 

48 1 

01 FA 

OO 

db 

C 

bit 6 

write pr ot ect , 

482 

01FB 

OA 

db 

1 0 

bit 5 

write fault, 

483 

01 FC 

06 

db 

6 

bit 4 

seek error , 

484 

01 FD 

04 

db 

4 

bit 3 

CRC error. 

485 

Ol FE 

OB 

db 

1 1 

bit 2 

lost data. 

486 

01 FF 

07 

db 

7 

bit 1 

* * Rob i n med i a* * 

487 

0200 

02 

db 

2 

bit O 

busy 

488 







489 

0201 

code ends 





490 

491 end 
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Segments and groups: 


align combine class 


CGROUP 

CODE 

Z80SEG 


GROUP 

0201 BYTE PUBLIC 'CODE' 

OOOO AT OOOO 


Symbo 1 s : 


N 


m e 


Type Value Attr 


AUXOP Number 0040 

AUXP Number 0042 

AUX_PRN Number 0044 

BUFFER V WORD OOOO External 

CLK_INT Number 002C 

COMOMA Number 0043 

COMMAND Number OOOO 

COUNT Number 0004 

CURTRK Number 0005 

OECOISK L NEAR OOOO CODE Global 

DENSITY Number 0006 

DMAADR V WORD OOOO External 

DMAOFF Number OOOC 

DMASEG Number OOOE 

DRIVE Number OO0 1 

DRVNO V BYTE OOOO External 

OSKIO Number 0065 

OTL Number 0009 

EGGSIT L NEAR 0159 CODE 

ENN Number 0008 

ERRCODE L BYTE 01F9 CODE 

EXCOM Number 0045 

EXECZ80 L NEAR 019C CODE 

EXSTAT V BYTE OOOO External 

FMTFNDL L NEAR 0105 CODE 

FMTSET L NEAR 0140 CODE 

FNCCOO V BYTE OOOO External 

GAPLEN Number 0007 

CSCR Number 0002 

HEAD Number 00 12 

IB8PKT V WORD OOOO External 

IBM8 Number 0008 

IBMBVAL Number OO0 1 

IBM9 Number 0002 

IBM9VAL Number 0002 

INTZ80 Number OOOO 

KDP Number 00 10 

KSP Number 0011 

LOGDRV L NEAR OOA4 CODE 

MC_FLG V BYTE OOOO External 

M0V1ST L NEAR OOE9 CODE 

NSECT V BYTE OOOO 

OTERFMT L NEAR 014B 


CODE 


External 
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OUTHERE. . 
PACKET . . 
PACKET ADR 
PMYS1.“. . 
PHYS2. . . 
PNYS3. . . 
PHYSOISK . 
PHYSDISK1 . 
PRNDP. . . 
PRNP . . . 
PROFILE. . 
PZW1 . . . 
OKCMCOM. . 
OKPMTCOM . 
OKRDCOM. . 
OKVFYCOM . 
OKWTCOM. . 
OKWVFCOM . 
REDFNDL. . 
ROM. . . . 
RX50 . . . 
RX50VAL. . 
SECNO. . . 
SECSIZ . . 
SECTOR . . 
SKEWTBL_2 . 
SKWED . . . 
SPARE4 1 . . 
SPARE42. . 
SPT. . . . 
STATUS . . 
STORY. . . 
TFORMAT. . 
TRACK. . . 
TRACKN . . 
TTRACK . . 
UART . . . 
VERT . . . 
WPRSNT . . 
XCOMMANO . 
XCOUNT . . 
XCPRSNT. . 
XOMAOFF. . 
XDMASEC. . 
XDRIVE . . 
XOSKFCN. . 
XFRPKT . . 
XPHORV . . 
XSECTOR. . 
XTRACK . . 
XZO. . . . 
XZ1 . . . . 
XZ2. . . . 
XZ3. . . . 
XZ4. . . . 


L NEAR 

017B 

CODE 


V BYTE 

oooo 


Ext erne V 

L NEAR 

oooo 


Ext erne 1 

L NEAR 

0080 

CODE 


L NEAR 

0080 

CODE 


L NEAR 

0084 

CODE 


L NEAR 

0060 

CODE 

Global 

F PROC 

0060 

CODE 

Length sOl 1 8 

Number 

004 1 



Number 

0043 



Number 

0064 



L NEAR 

01 10 

CODE 


Number 

0015 



Number 

0024 



Number 

0013 



Number 

0023 



Number 

0014 



Number 

0016 



L NEAR 

01O0 

CODE 


Number 

0018 



Number 

OOOO 



Number 

OOOO 



V BYTE 

OOOO 


External 

Number 

OOOA 



Number 

0003 



L BYTE 

01EE 

CODE 


L NEAR 

OOC5 

CODE 


Number 

004 1 



Number 

0042 



Number 

0O10 



V BYTE 

OOOO 


Ext er na 1 

L NEAR 

OOAC 

CODE 


V BYTE 

OOOO 


Externa 1 

Number 

0002 



V BYTE 

OOOO 


Ext er na 1 

V BYTE 

OOOO 


External 

Number 

0046 



Number 

0040 



Number 

OO01 



Number 

OOOO 



Number 

0006 



Number 

0002 



Number 

0006 



Number 

OOOA 



Number 

OO01 



L NEAR 

01 7F 

CODE 


V WORD 

OOOO 


External 

Number 

0003 



Number 

0002 



Number 

0004 



L NEAR 

01 B2 

CODE 


t NEAR 

01 BA 

CODE 


L. NEAR 

01 C7 

CODE 


L NEAR 

01 E8 

CODE 


L NEAR 

01E1 

CODE 
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XZ5. . 
XZ80ERR 

zso. . 

ZSOISR 
ZDSKFCN 
ZI 1 . . 

ZPKT . 
ZWO. . 


L 

NEAR 

01 EC 

L 

NEAR 

0102 

Number 

0047 

L 

NEAR 

0187 

L 

BYTE 

0065 

L 

NEAR 

0197 

L 

WORD 

0185 

L 

NEAR 

002F 


CODE 

CODE 

CODE Global 

CODE 

CODE 

CODE 

CODE 


Warning Severe 
Errors Errors 
O 0 



DEC Rainbow Rx*BO/ZtO disk drivor 

Symbol Cross Roforonce 

AUXDP 

Auxr 

AUX_PRN 

BUFFER 

CGROUF 

CLK INT 

CODE 

COMDMA 

COMMAND 

COUNT 

CURTRK 

DECO ISK 

DENSITY 

OMAADR 

OMAOFF 

DMASEG 

DRIVE 

ORVNO 

OSKIO 

OTL 

BGGSIT 

ENN 

ERRCOOE 

EXCOM 

EXECZ80 

EXSTAT 

FMTFNDL 

FMTSET 

FNCCOD 

CAPLEN 

GSCR 

MEAD 

IA8PKT 

IBM8 

IBM8VAL 

IBM9 

IBM9VAL 

INTZ80 

KOP 

KSP 

LOGORV 

MC FLC 

M0V1ST 

NSECT 


(# IS definition) Crof-1 

83# 

88 # 

73# 


18# 

294 

306 

363 

1 1 

142 

1 42 


59# 




1 1 

141# 

141 

489 

72# 




96# 

195 



100# 

180 



101# 




17 

1 50# 



102# 

1 68 



136# 

193 

313 

342 

107# 

192 



108# 

187 



97# 

155 



132# 

1 60 

266 


80# 




105# 




330 

346# 



104# 




451 

478# 



74# 




203 

325 

4 10# 


137# 

440 



286 

307# 



336 

340 

342# 


1 30# 

199 

3 1 6 



103# 

30# 

1 10 # 


128 # 

43# 337 

47# 339 

44# 

48# 341 

29# 399 414 

8 1# 

82# 

259 262# 

18# 242 244 

287# 

135# 181 276 


DEC Rainbow RX-B0/Z80 disk driver 

Symbol Cross Reference 

OTERFMT 

OUTHERE 

PACKET 

PACKET ADR 

PHYS 1 

PHYS2 

PHYS3 

PHYSDISK 

PHYSDISK1 

PRNOP 

PRNP 

PROFILE 

P2W1 

OKCMCOM 

OKFMTCOM 

OKROCOM 

QKVFYCOM 

OKWTCOM 

QKWVFCOM 

REOFNDL 

ROM 

RXBO 

RXSOVAL 

SECNO 

SECSIZ 

SECTOR 

SKEWTBL 2 

SKWEO 

SPARE4 1 

SPARE42 

SPT 

STATUS 

STDRV 

TFORMAT 

TRACK 

TRACKN 

TTRACK 

UART 

VERT 

WPRSNT 

XCOMMANO 

XCOUNT 

XCPRSNT 

XDMAOFF 

X DMASEG 

XDRIVE 

XDSKFCN 

XFRPKT 


(# Is definition) Cref-2 

338 341# 

353 371# 

1 29# 4 1 1 

1 1 8 # 

232 247# 

238 242# 

241 243# 

17 227# 

228# 381 

84# 

86 # 

58# 

320# 


24# 

209 

379 

27# 

378 


22# 

208 

375 

28# 

380 


23# 

208 

376 

2B# 

208 

377 

282 

304# 


77# 

42# 

48# 



133# 

108# 

177 

275 

99# 

1 87 


175 

273 

482# 

271 

274# 


70# 

71# 

109# 

131# 

413 

432 

281 

288# 


1 It# 

334 


98# 

170 

178 

134# 

120# 

179 

274 

7B# 



69# 



80# 



32# 

230 

278 

37# 



81# 



38# 

284 

380 

38# 

283 

3B8 

33# 

2B7 


316 

37B# 


124# 

387 

411 


811 


41B 



DEC Rainbow Rx>50/Z80 disk driver 

Symbol Cross Reference (# is definition) 


XPHDRV 35# 260 

XSECTOR 34# 269 

XTRACK 36# 267 

XZO 419# 420 

XZ1 424# 429 

XZ2 426 431# 

XZ3 447 451# 

XZ4 442 446# 449 

XZ5 444 452# 

XZ60ERR 434 436# 


Cref -3 


zeo 76# 

Z80ISR 17 393# 

Z60SEG 115# 1 16 142 151 253 395 41 1 

ZDSKFCN 198 209# 

ZI 1 399# 

ZPKT 391# 398 412 425 

ZWO 1 69 17 1 177# 
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1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
1 1 
1 2 
1 3 
1 4 
1 5 
1 6 
1 7 
1 8 

1 9 
20 

2 1 

22 OOOO 

23 

24 

25 

26 

27 

28 

29 

30 

31 > 0064 

32 = 002C 

33 : 0065 

34 

35 

36 

37 

38 

39 

40 
4 1 

42 * 0040 

43 s 0041 

44 3 0042 

45 8 0043 

46 8 0044 

47 * 0045 

48 > 0046 

49 = 0047 

50 * 0018 

51 

52 

53 

54 

55 


PAGE 60,132 

TITLE Rainbow Interrupt fix routines 
NAME INTFIX 


COMPANY CONFIDENTIAL 

Copyright (C) 1983 Digital Equipment Corporation 

All rights reserved. 


C 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 


cgroup group code 

;P1aced at the 2X interrupts, dispatch to 
;either the proper MSDOS interrupt or 
;the hardware vector, determined by looking 
;at the last executed instruction. 

public i nt 20 , i nt 2 1 , i nt 24 , i nt 25 , i nt 2 6 , i nt 2 7 
public dos20vec , dos2 1 vec , dos24vec 
publ ic dos25vec,dos26vec,dos27vec 

code segment byte public 'code' 
assume c s ; cgr oup , ds : not h i ng 
include iodef.ash 
;Rainbow Interrupt numbers. 

;1 -Apr-83 sgs added dskio i nt vector 

;19-Mar-83 sgs added profile i nt vector [user clock] 

;the i nt profile is called by the RTC interrupt service for each tick. 
;The ax and ds register don't need to be saved [done in clkisr]. 

profile equ 64h ; 1 OO . user interface to clock interrupt 

clk^int equ 2ch ; 6 OH 2 i nt , 

dskTo equ 65h ;direct disk io for format 

;17-Mar-83 sgs changed to include i nt 20-26 

; interrupt 22-24h are duplicated at 42-44h for consistency. 

;These are the relocated Rainbow interrupts. 

; interrupts, 20h-26h moved to 40h-46h 

;ATTENTION Modules lOINIT and REINIT may have to be 
;changed if i nt vectors 40h to 46h are changed 

vert equ 40h ; new vert. freq. 

spare4l equ 4lh 

spare42 equ 42h 

comdma equ 43h ; DMA Ctrl optional coram. board 

aux^prn equ 44h ;7201 coram ./ pr i nt er 

excom equ 45h ;extented coram. option 

uart equ 46h ; new UART vector, 

280 equ 47h ; Z80 interrupt, 

rora equ 18h ; new ROM access, 

;DEC Rainbow ID port stuff. 


8 0010 
8 001 1 


C kdp 
C ksp 


equ 

equ 


lOh 
1 1h 


; 825 1 data port . 
;82S1 status. 
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S8 * 0040 

57 s 0041 

58 * 0042 

59 B 0043 

60 
61 
62 

63 c 0001 

64 < 0002 


C 

c 

c 

c 

c 

c 

c 

c 

c 


auxdp equ 40h 

prndp equ 41h 

auxp equ 42h 

prnp equ 43h 

: Values in XOPTION 

wprsnt equ 01 

xcprsnt equ 02 


;7201 data, 

; 7201 command , 


;Winnie preset 
;XCOMM present 
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65 



page 

66 





67 




Oword pointers into the DOS. 

68 




ATTENTION must be one blocK for block move 

69 





70 

OOOO 

7777'»77*> 

dos20vec dd (?) 

7 1 

0004 

77777777 

dos21vec dd (?) 

72 

0008 


dos24vec dd (?) 

73 

OOOC 


dos2Svec dd (?) 

74 

OO10 


dos26vec dd (?) 

75 

00 14 


dos27vec dd (?) 

76 





77 




INT 20 code. We must te11 a software interrupt 

78 




from a hardware one. 

79 





60 





81 




i nt 20 code; 

62 





83 




if flag set , 

64 




hardware interrupt, 

65 




c 1 ear f lag , 

66 




i r et . 

67 





68 




set flag, 

69 




enable interrupts. 

60 




nop . 

9 1 




disable interrupts, 

62 




if CD 20 on stack. 

63 




if f1ag20 set or IP 2. 

64 




c 1 ear flag. 

65 




software interrupt. 

66 




iret. ” 

67 
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PAGE 


1-4 


S8 

88 

100 

101 

102 

103 

104 

105 
108 

107 

108 
108 
1 10 
1 1 1 
1 1 2 
1 13 
1 14 
1 15 
1 1 8 
1 17 
1 18 
1 18 
120 
121 
122 

123 

124 

125 

126 

127 

128 
128 
1 30 

131 

132 

133 

134 

135 

136 

137 


page 

intmac necro nn.hwi 

;Attempt to figure out where to go. The "soft 
;parts" (our ambiguity) are marked with <*>. 

flagAnn db O 


intann proc far 
dec 
jni 
i nt 
i ret 


cs : f lagAnn 
i 8nn8a 

hwi 


;<«> if flag was 
: < * > set , must 
; be hardware 
; serv ice i t . 


Dont Know what type of interrupt yet. NOTE: 
The STl is done first: any pending interrupt 
will NOT be serviced until the MOV FLAC.I is 
executed. Absolute minimum ambiguity. 


St i 

mov 
c 1 i 
emp 
jni 


cs : f lagAnn , 1 


cs : f lagAnn. O 
i AnnAb 


<*> enable ints, 
<*> set flag, 
off again, 
i f f lag c lear . 
it's hardware 


Hmm. Flag cleared. Either a hardware interrupt 
or a software interrupt that got interrupted 
in our soft parts. All we can do is assume 
it was a hardware interrupt. Goodbye. 

i r at 


We reenabled interrupts, and didn't get inter- 
rupted. Must be software. 


iAnnAb: mov csrflagAnn.O 

jmp dword pt r dosAnnAvec 

intAnn endp 
endm 
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138 

138 

140 

141 

142 

143 

144 

145 

146 

147 

148 
148 

150 

151 

152 

153 

154 


0018 

OO 







0018 







+ 

0018 

2E 

FE 

OE 

0018 

R 


+ 

0O1E 

75 

03 





♦ 

0020 

CO 

40 





+ 

0022 

CF 






♦ 

0023 

F8 






♦ 

0024 

2E 

C6 

06 

0018 

R 

01 

♦ 

002A 

FA 






♦ 

0028 

2E : 

; 80 

3E 

0018 

R 

OO 

♦ 

0031 

75 

01 





+ 

0033 

CF 






♦ 

0034 

2E : 

: C6 

06 

0018 

R 

OO 

♦ 

003A 

2E : 

: FF 

2E 

OOOO 

R 


+ 

003F 







* 


page 

intmac 20, vert 
f1ag20 db O 

int20 proc far 

dec cs:f1ag20 

Jnz i20a 

i nt vert 

iret 

i 20a : st i 

mov cs : f 1ag20 . 1 

c 1 i 

emp cs:f1ag20,0 

jnz i20b 

i r et 

i20b: mov 

jmp 

int20 endp 


<*> if flag was 
< ♦ > set , must 
be hardware 
serv ice it. 

<*> enable ints, 
<*> set flag, 
off again, 
if f lag c lear . 
it's hardwar e 


cs : f 1ag20 . O 
dword ptr dos20vec 
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O2-20-S4 


RAGI 


1-f 


1GB 









paoo 



IBS 









1 ntmac 

21 . 41h 


1B7 

003P 

OO 






♦ 

f1ag2l db 

0 


IBB 

0040 







♦ 

1nt21 pr oc far 



IBB 

0040 

2B ; 

: FE 

OE 

003F 

R 


♦ 

doc 

cs : f 1ag21 

;<«> If flag was 

1BO 

004S 

7B 

03 





♦ 

Jn* 

121a 

;<*> sot, must 

1B1 

0047 

CD 

41 





♦ 

1 nt 

41h 

;bo hardwaro 

1 82 

0048 

CF 






♦ 

Irot 


; sorv ico It . 

1B3 

004A 

FB 






* 

121a: St 1 


;<*> onablo Ints 

1 B4 

004B 

2E : 

: C6 

OB 

003F 

R 

oi 

♦ 

nev 

CS : f 1ag2l . 1 

;<*> sot flag, 

1 SB 

OOB1 

FA 






♦ 

cl 1 


;off again. 

1 BB 

OOS2 

2E : 

: BO 

3E 

003F 

R 

OO 

♦ 

emp 

cs : f 1ag2 1 , 0 

: 1 f flag c loor , 

1 B7 

OOBB 

7B 

01 





* 

jni 

121b 


IBB 

OOBA 

CF 






* 

irot 



IBB 

OOBB 

2E : 

: CB 

06 

003F 

R 

OO 

* 

121b: niev 

cs: f lag2l .0 


170 

0081 

2E : 

: FF 

2E 

0004 

R 


♦ 

Jmp 

dword ptr des21voc 

171 

OOB6 







4 

1nt21 ondp 
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FACE 1-7 


Rainbow Interrupt 

f lx 

rout i nos 








172 









pogo 




173 










i ntmoc 

24 , 44h 


1 74 

0086 

OO 






♦ 

f i«g24 

db 

O 


1 75 

0067 







♦ 

i nt 24 

proc for 



176 

0067 

2E 

FE 

OE 

0066 

R 


♦ 


dec 

CS : f 1ag24 

<*> if flag was 

177 

006C 

75 

03 





♦ 


jnt 

i24o 

< * > sot , must 

178 

006E 

CO 

44 





4 


i nt 

44h 

be hardwaro 

1 78 

0070 

CF 






+ 


irot 


sorv ice it. 

1 80 

007 1 

FB 






+ 

1 24« : 

St i 


<«> enable ints 

181 

0072 

2E 

: C6 

06 

0066 

R 

OI 

+ 


raov 

cs : f 1og24 , 1 

<* > set flag. 

1 82 

0078 

FA 






♦ 


c 1 i 


off again, 

1B3 

0079 

2E : 

: 80 

3E 

0066 

R 

OO 

♦ 


emp 

cs : f 1og24 , O 

if flag cl oar , 

1B4 

007F 

75 

01 





4 


jno 

124b 

it's har dwar e 

1 85 

006 1 

CF 






4 


irot 



IBS 

OOB2 

2E : 

: C6 

06 

0066 

R 

OO 

4 

1 24b: 

mov 

cs : f 1ag24 , 0 


187 

OOBB 

2E : 

; FF 

2E 

0008 

R 


4 


jmp 

dword ptr dos24voc 

IBB 

OOBD 







4 

int24 

ondp 
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RAGE 


1-8 


188 









page 




180 










i nt mac 

25.45h 


181 

008D 

00 






♦ 

f 1aa2S 

db 

O 


182 

008E 







♦ 

int25 

proc far 



183 

008E 

2E 

FE 

OE 

0080 

R 


+ 


dec 

cs : f 1ag25 

<«> if flag was 

184 

008 3 

75 

03 







jna 

i25a 

<*> set. must 

188 

0085 

CD 

45 





+ 


int 

45h 

be hardware 

186 

008 7 

CF 






+ 


iret 


serv ice it . 

187 

0088 

FB 






+ 

i25e: 

St i 


<«> enable ints. 

188 

0088 

2E : 

: C8 

06 

0080 

R 

01 

+ 


mov 

cs: f 1ag25, 1 

<»> set flag. 

188 

008F 

FA 






♦ 


c 1 i 


off again. 

200 

OOAO 

2E : 

: 80 

3E 

0080 

R 

oo 

♦ 


emp 

cs: f 1ag25,0 

if flag cl ear , 

201 

OOA6 

75 

oi 





♦ 


jn* 

i25b 

it's hardware 

202 

OOA8 

CF 








iret 



203 

OOA8 

2E : 

: C6 

06 

0080 

R 

oo 

♦ 

i28b: 

mov 

cs : f 1ag25 . 0 


204 

OOAF 

2E : 

: FF 

2E 

OOOC 

R 


+ 


jmp 

dword ptr dos25vec 

205 

0054 







♦ 

int25 

andp 
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f ix 

rout i nes 







206 








page 



207 








;Keyboard interrupt. Set a flag, reenable 

208 








; i nt or r upt s . If 

flag gets cleared, it was 

209 








; har dwar e . 


2 1 O 








; 



2 1 1 









i ntmac 

2 6 , uar t 

212 

OOB4 

OO 





+ 

f 1ag26 

db 

0 

213 

OOB5 






+ 

i nt 26 

proc far 


214 

OOB5 

2E 

FE 

OE OOB4 

R 


+ 


dec 

cs:f1ag26 ;<»> if flag was 

2 1 S 

OOBA 

75 

03 




+ 


jnt 

i26a ;<*> set. must 

2 1 6 

OOBC 

CD 

46 




+ 


i nt 

uart ; be hardware 

2 1 7 

OOBE 

CF 





♦ 


i r et 

; serv ice i t . 

2 1 8 

OOBF 

FB 





♦ 

i 26a : 

St i 

; < * > enab 1 e ints. 

2 1 9 

OOCO 

2E : 

: C6 

06 OOB4 

R 

01 

+ 


mov 

cs:f1ag26,l ;<*> set flag. 

220 

OOC6 

FA 





+ 


c 1 i 

; of f aga i n , 

22 1 

OOC7 

2E : 

: 80 

3E 00B4 

R 

OO 

+ 


crap 

cs:flag26,0 ;if flag clear. 

222 

OOCO 

75 

OI 




+ 


jn2 

i26b ;it's hardware 

223 

OOCF 

CF 





+ 


i r et 


224 

OODO 

2E 

; C6 

06 OOB4 

R 

OO 

♦ 

i 26b: 

mov 

cs : f lag26 , 0 

226 

0006 

2E 

: FF 

2E 0010 

R 


+ 


jrap 

dword ptr dos26vec 

226 

OODB 






♦ 

int 2 6 

endp 
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RACE 


I - 10 


227 pago 


228 









; Z80 

i nt err upt . 

Sat tha flag, if 

wa gal 

229 









: r a i nt ar r upt ad . 

it was tha 280. 


230 









; 




231 










i ntmac 

27.980 


232 

OOOB 

OO 






♦ 

fiag27 db 

O 


233 

OOOC 







♦ 

int27 

proc far 



234 

OOOC 

2E 

FE 

OE 

OODB 

R 


* 


dec 

cs : f 1ag27 

<*> if flag was 

23B 

00E1 

75 

03 





+ 


jn* 

i27a 

< * > sat , must 

238 

OOE3 

CD 

47 







int 

980 

be hardware 

237 

OOEB 

CF 






+ 


i rat 


sarv i ca it. 

238 

00E6 

FB 






♦ 

i27a : 

St i 


<»> enable ints. 

239 

00E7 

2E : 

: C6 

06 

OODB 

R 

01 

♦ 


mov 

cs : f 1ag27 , 1 

<*> sat flag. 

240 

OOED 

FA 






♦ 


c 1 i 


off again. 

241 

OOEE 

2E : 

; 80 

3E 

OODB 

R 

00 

* 


crap 

cs:f 1ag27.0 

i f f lag c 1 ear . 

242 

OOF4 

75 

01 





♦ 


jn» 

i27b 

it's hardware 

243 

OOF6 

CF 






♦ 


irat 



244 

OOF7 

2E : 

; C8 

06 

OODB 

R 

OO 

♦ 

i27b: 

mov 

cs : f 1ag27 . O 


245 

OOPD 

2E 

: FF 

2E 

0014 

R 


♦ 


jrap 

dword ptr dos27vac 

248 

0102 







♦ 

int27 

andp 




247 

244 0102 coda onds 

249 

2B0 and 
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Macros : 


Name 

INTMAC 

Sagmants and groups: 

Name 

CGROUP 

CODE 

Symbo 1 s : 


Langt h 
00 1 C 

Siza align combine class 

GROUP 

0102 BYTE PUBLIC 'CODE' 


N 


e 


Typa Value Attr 


AUXDP. . 
AUXP . . 
AUX_PRN . 
CLK INT. 
CO MDMA . 
DOS20VEC 
D0S2 1 VEC 
D0S24VEC 
D0S25VEC 
00S26VEC 
D0S27VEC 
DSKIO. . 
EXCOM. . 
FLAG20 . 
FLAG21 . 
FLAG24 . 
FLAG25 . 
FLAG26 . 
FLAG27 . 
I20A . . 
I20B . . 
I21A . . 
I21B . . 
I24A . . 
I24B . . 
I25A . . 
I25B . . 
I26A . . 
I26B . . 
I27A . . 
127B . . 
INT20. . 
INT21 . . 
INT24. . 
INT25. . 
INT26. . 
INT27. . 
KDP. . . 


Number 0040 
Number 0042 
Number 0044 
Number O02C 
Number 0043 
L DWORD OOOO 
L DWORD 0004 
L DWORD 0008 
L DWORD OOOC 
L DWORD OOlO 
L DWORD 0014 
Number 0065 
Number 0045 
L BYTE 0018 
L BYTE 003F 
L BYTE 0066 
L BYTE 0080 
L BYTE OOB4 
L BYTE OOOB 
L NEAR 0023 
L NEAR 0034 
L NEAR 004A 
L NEAR 005B 
L NEAR 0071 
L NEAR 0082 
L NEAR 0098 
L NEAR OOA9 
L NEAR OOBF 
L NEAR OODO 
L NEAR 00E6 
L NEAR OOF7 
F PROC 0019 
F PROC 0040 
F PROC 0067 
F PROC 008E 
F PROC 00B5 
F PROC OODC 
Number 0010 


CODE 

G 1 oba 1 

CODE 

C 1 oba 1 

CODE 

Global 

CODE 

Global 

CODE 

Global 

CODE 

Global 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CODE 


CDDE 


CODE 

Global 

CODE 

Global 

CODE 

Global 

CODE 

Global 

CODE 

G 1 oba 1 

CODE 

Global 


Length >0026 
Length >0026 
Length >0026 
Length >0026 
Length >oo26 
Length >0026 
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02>20-«4 


RACE 


SyMbe1S'2 


KtP. . 
PRNOR. 
RRNR . 
PROFILE 
ROM. . 
SPARE# 1 
SPARE42 
UART . 
VERT . 
WPRSNT 
XCPRSNT 

zse. . 


Number 

O01 1 

Number 

0041 

Number 

0043 

Number 

OOB4 

Number 

0014 

Number 

0041 

Number 

0042 

Number 

004 8 

Number 

0040 

Number 

0001 

Number 

0002 

Number 

0047 


Warning Savor# 
Errors Errors 
O O 


Rainbow Intorrupt fix reutinos 


Symbol Cress Roforonco 

AUXDP 

AUXP 

AUX^PRN 

CCROUP 

CLK IHT 

CODE 

COMDMA 

0OS2OVEC 

00S21VEC 

D0S24VEC 

00S2BVEC 

DOS26VEC 

D0S27VEC 

OSKIO 

EXCOM. 

PLAG20 

PLAG21 

FLAG24 

PLAG25 

PLAG26 

FLAG27 


(# is definition) Crof-1 


B8# 





S8# 





46# 

* 1 

23 




32# 





1 1 

22# 

22 

248 


4B# 





19 

70# 

1B3 



19 

71# 

170 



19 

72# 

187 



20 

73# 

204 



20 

74# 

226 



20 

78# 

24S 



33# 





47# 





140# 

142 

147 

149 

152 

197# 

189 

1 84 

1 66 

169 

174# 

1 76 

181 

183 

186 

191# 

193 

198 

200 

203 

212# 

2 1 4 

219 

22 1 

224 

232# 

234 

239 

241 

244 


I20A . 
I20B . 
121 A . 
I21B . 
I24A . 
I24B . 
I2SA . 
125B . 
I26A . 
I26B . 
I27A . 
I27B . 
INT20. 
INT21 . 
INT24 . 
INT2S . 
INT28 . 
1WT27 . 
INTMAC 


143 

146# 


180 

152# 


1 60 

1 63# 


1 67 

1 69# 


177 

1 80# 


184 

186# 


194 

197# 


201 

203# 


215 

218# 


222 

224# 


235 

238# 


242 

244# 


18 

141# 

154 

18 

188# 

171 

18 

175# 

188 

18 

192# 

205 

18 

213# 

226 

18 

233# 

246 

139 

156 

173 


KDP S4# 

KSP BSP 


PRMDP .... B7# 

PROP B9# 

PROFILE 31# 

ROM BO# 

SPARE41 43# 

SPARE42 44# 



A 


nbew tnt«rrupt ffx reutfnas 
Sywbel Cress Reference 

UART 

VIRT 

WRRSNT 

XCRRSNT 

ZSO 


(# is definitien) Cref*2 


48# 

218 

42# 

144 

83# 


84# 


48# 

238 
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1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
1 1 
1 2 
1 3 
1 4 
IS 
1 6 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 OOOO 

30 

31 

32 

33 

34 

35 

36 

37 

38 B 

39 s 

40 « 

4 1 

42 

43 

44 
46 

46 

47 

48 

49 « 

50 * 

51 B 

82 > 

53 B 

54 B 

86 B 


0064 
O02C 

0065 


0040 

0041 

0042 

0043 

0044 
0046 
0046 


PAGE 80,132 

TITLE DEC Rainbow Interrupt vector initialization 
NAME REINIT 


CDMPANY CONFIDENTIAL 

Copyright (C) 1983 Digital Equipment Corporation 

All rights reserved. 


cgroup group code 

; Copies the MSDOS interrupt vectors 

;from the 2x block to the Fx block, installs 
.'the magic routine at 2x. which will determine 
:the interrupt source, and dispatch to the right 
i vect or . 


C 

C 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 


public ro_init . r lOO.xopt ion 


ext rn 
ext r n 
ext r n 
ext r n 
ext r n 
ext r n 


i nt 20 : near . i nt 2 1 : near 
i nt 25 : near , i nt 24 : near 
int26.near. int27: near 
dos20vec : dwor d . dos2 1 vec : dwor d 
dos25vec : dword . dos24vec : dwor d 
dos26vec : dword . dos27vec : dword 


cede segment byte public 'code' 
assume cs : cgroup . ds : cgroup 
include iodef.ash 
; Rainbow Interrupt numbers. 

;1 -Apr-83 sgs added dskio i nt vector 

;19-Mar-83 sgs added profile i nt vector [user clock] 

;the int profile is called by the RTC interrupt service for each tick. 
;The ax and ds register don't need to be saved (done in clkisr]. 


pr of i 1 e equ 
clk__int equ 
dskio equ 


64h 

2ch 

65h 


;100. user interface to clock interrupt 
;80Hz int. 

;direct disk io for format 


;17-Mar-83 sgs changed to include int 20-26 

; interrupt 22-24h are duplicated at 42-44h for consistency. 
;These are the relocated Rainbow interrupts, 
interrupts. 20h-26h moved to 40h-46h 
:ATTENTIDN Modules lOINIT and REINIT may have to be 
;changed if int vectors 40h to 48h are changed 


vert 

equ 

40h 

spare4 1 

equ 

4lh 

spare42 

equ 

42h 

c omdma 

equ 

43h 

aux^pr n 

equ 

44h 

excom 

equ 

4Sh 

uart 

equ 

48h 


: new vert . f r eq . 


; DMA Ctrl optional comm, board 
;7201 comm . /pr i nt er 
;extented comm, option 
: new UART vector. 
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56 

t 

0047 

c 

Z60 

equ 

47h 

; 260 

interrupt 

57 

z 

0016 

c 

rom 

equ 

16h 

; new 

ROM acces 

55 



c 

; 





55 



c 

;DEC Rainbow 

10 port 

stuff . 


60 



c 

; 





61 

z 

00 10 

c 

kdp 

equ 

lOh 

;62S1 

data por 

62 

z 

001 1 

c 

ksp 

equ 

1 1h 

;6251 

status. 

63 

z 

0040 

c 

auxdp 

equ 

40h 

; 7201 

data. 

64 

z 

0041 

c 

pr ndp 

equ 

4 1h 



65 

z 

0042 

c 

auxp 

equ 

42h 

; 7201 

command , 

66 

t 

0043 

c 

prnp 

equ 

43h 



67 



c 

; 





66 



c 

; Values in 

XOPTION 



69 



c 

; 





70 

1 

0001 

c 

wpr snt 

equ 

oi 

;Winn 

ie preset 

71 

z 

0002 

c 

xcpr snt 

equ 

02 

;XCOMM present 
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DEC Re 

nbow Interrupt vector i n i t i a 1 i zat i on 



72 



page 



73 






74 

OOOO 


re i n i t pr oc 

far 

75 






76 



; Copy 

the DOS 

interrupts to a safe place, then 

77 



; i nst a 1 1 our 

magic routines there. 

76 



; 



79 

OOOO 

FA 


c 1 i 


60 

0001 

50 


push 

ax 

61 

0002 

53 


push 

bx 

82 

0003 

5 1 


push 

cx 

83 

0004 

52 


push 

dx 

84 

0005 

56 


push 

S i 

85 

0006 

57 


push 

d i 

86 

0007 

IE 


push 

ds 

87 

0008 

06 


push 

es 

88 






89 

0009 

OE 


push 

cs 

90 

OOOA 

1 F 


pop 

ds 

9 1 

0006 

F6 

06 0077 R FF 

t est 

byte ptr r1O0,0ffh ; check 100A or 100B 

92 

OO10 

74 

03 

j* 

rIOOa 

93 

0012 

EB 

59 90 

jmp 

SK i p 

94 






95 



; Copy 

INT 20, 

21, 24, 25, 26 and 27 vectors to the BIOS 

96 



;dword places 

dosxxvec must be squential [intfix.asm] 

97 






98 

00 15 

68 

OOOO rIOOa 

mov 

ax , 0 ; DS ; s low mem. 

99 

00 1 8 

8E 

08 

ffiOV 

ds , ax 

1O0 

001 A 

OE 


push 

cs 

101 

0016 

07 


pop 

es ;ES:s BIOS. 

102 






103 

001 C 

FC 


c Id 


104 

001 D 

B9 

0004 

mov 

cx, 2*2 : 2 vectors 

105 

0020 

BE 

0080 

mov 

si,20h*4 ;save INT 20,21 

106 

0023 

BF 

OOOO E 

mov 

di, offset dos20vec ;in our CS : , 

107 

0026 

F3/ 

A5 

rep movsw 

108 






109 

0028 

B9 

0008 

mov 

cx,4*2 ;4 vectors 

1 10 

0026 

BE 

0090 

mov 

Si.24h*4 :save INT 24, 25, 26, 27 

1 1 1 

002E 

BF 

OOOO E 

mov 

di, offset dos24vec ;in our CS : , 

1 1 2 

0031 

F3/ 

A5 

rep movsw 

113 



; 



! 114 



; I nst 

all our 

drivers in the interrupt vectors. 

1 1 5 



; 



1 1 6 

0033 

B8 

OOOO 

mov 

ax,0 ;ES:s low mem. 

1 1 7 

0036 

8E 

CO 

mov 

es , ax 

1 1 8 






1 1 9 

0038 

BF 

0080 

mov 

di,20h*4 ; install ours, i 

1 20 

0036 

B8 

OOOO E 

mov 

ax, offset int20 ' 

1 2 1 

003E 

AB 


St osw 


122 

003F 

8C 

C8 

mov 

ax , cs 

123 

0041 

AB 


St osw 


124 






125 

0042 

B8 

OOOO E 

mov 

ax, offset int21 

126 

0045 

AB 


St osw 
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127 

004 6 

9C 

C6 

niov 

ax , cs 




12« 

0046 

A9 


St osw 





129 









ISO 




rastora original vactor 

in 22, 

23 


131 




nsdos changad 

tham at tnit tima 



132 









133 

0049 

99 

0004 

mov 

cx . 2*2 


;2 vectors 


134 

004C 

9E 

0106 

mov 

si . 42h*4 


: dup 1 icat ad 

vectors 

135 

O04F 

F3/ 

A5 

rap movsw 




136 









137 




d1 now points 

to Int 24h 




136 









139 

005 1 

96 

OOOO E 

mov 

ax . offset 

Int 24 



140 

0054 

A6 


St osw 





1 4 1 

0055 

6C 

C6 

mov 

ax . cs 




142 

0057 

A6 


St osw 





143 

0056 

96 

OOOO E 

mov 

ax , offset 

1nt25 



1 44 

0059 

A6 


St osw 





1 45 

005C 

8C 

C8 

mov 

ax . cs 




146 

005E 

A6 


St osw 





147 

005F 

96 

OOOO E 

mov 

ax , offset 

Int 2 6 



146 

0062 

A6 


St osw 





1 49 

0063 

6C 

C6 

mov 

ax , cs 




1 50 

0065 

A6 


St osw 





151 

0066 

66 

OOOO E 

mov 

ax , offset 

1 nt 27 



152 

0069 

A6 


St osw 





153 

006A 

6C 

C8 

mov 

ax . cs 




1 54 

006C 

A6 


St osw 





1 55 









156 




6oth 100A/6 

come hare to finish system vector setup 

1 57 









156 

0060 

07 


Skip; pop 

as 




159 

006E 

1 F 


pop 

ds 




1 60 

006F 

5F 


pop 

d i 




1 6 1 

0070 

5E 


pop 

si 




1 62 

007 1 

5A 


pop 

dx 




1 63 

0072 

59 


pop 

cx 




1 64 

0073 

59 


pop 

bx 




1 65 

0074 

56 


pop 

ax 




1 66 

0075 

F9 


St i 



; Re ■ enab 1 a 

i nt s 

1 67 

0076 

C6 


r at 





1 66 









1 69 

0077 

OO 


noo db 

0 




1 70 

0078 

OO 


Kopt i on db 

o 




1 7 1 









1 72 

0079 



ro_init endp 





173 









1 74 

0079 



coda ends 





1 75 









176 




and 
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Symbo 1 s - 1 

DEC Rainbow Interrupt 

vect or initial 

zat i on 




Segments and groups: 







Nam 

e 

Size 

align 

combi ne 

c lass 

CCROUP .... 



GROUP 




CODE .... 



0079 

6YTE 

PU9L IC 

' CODE ' 

Symbo 1 s : 

Nam 

e 

Type 

Value 

Att r 


AUXDP 



Number 

0040 



AUXP 



Number 

0042 



AUX PRN .... 



Number 

0044 



CLK INT. . . . 



Number 

002C 



COMDMA .... 



Number 

0043 



D0S2OVEC . . . 



V DWORD 

OOOO 


Ext er na 1 

D0S21VEC . . . 



V DWORD 

OOOO 


Ext er na 1 

D0S24VEC . . . 



V DWORD 

OOOO 


Ext er na 1 

D0S25VEC . . . 



V DWORD 

OOOO 


Ext er na 1 

D0S26VEC . . . 



V DWORD 

OOOO 


Ext er na 1 

D0S27VEC . . . 



V DWORD 

OOOO 


Ext er na 1 

OSKI 0 



Number 

0065 



EXCOM 



Number 

0045 



INT20 



L NEAR 

OOOO 


Ext er na 1 

INT2 1 



L NEAR 

OOOO 


Ext er na 1 

INT24 



L NEAR 

OOOO 


Ext er na 1 

INT25 



L NEAR 

OOOO 


Ext er na 1 

INT26 



L NEAR 

OOOO 


Ext erne 1 

1NT27 



L NEAR 

OOOO 


Ext erne 1 

KDP 



Number 

OO 10 



KSP 



Number 

00 1 1 



PRNDP 



Number 

004 1 



PRNP 



Number 

0043 



PROFILE. . . . 



Number 

0064 



R100 



L 6YTE 

0077 

CODE 

Global 

R100A 



L NEAR 

00 15 

CODE 


RE I NIT. . . 



F PROC 

OOOO 

CODE 

Global Length e0079 

ROM 



Number 

OO 1 8 



SKIP 



L NEAR 

006D 

CODE 


SPARE4 1 .... 



Number 

0041 



SPARE42 . . . . 



Number 

0042 



UART 



Number 

0046 



VERT 



Number 

0040 



WPRSNT .... 



Number 

0001 



XCPRSNT . . . . 



Number 

0002 



XOPTION . . . . 



L 9YTE 

0078 

CODE 

Global 

280 



Number 

0047 



War n i ng Severe 
Errors Errors 







0 O 










DtC Rainbow Intorrupt voetor 

Initial Hat Ion 



Symbol Cross Roforoneo 


(# IS 

dof Init Ion) 

Craf - 1 

AUXDP 

S3# 




AUXP 

SS# 




AUX PRN 

53# 




CGROUP 

1 1 

30 

30 


CLK INT 

3S# 




CODE 

1 1 

29# 

29 174 


COMOMA 

82# 




D0S2OVEC 

25# 

106 



D0S21VEC 

2B# 




00S24VEC 

26# 

1 1 1 



D0S2SVEC 

26# 




D0S2BVEC 

27# 




D0S27VEC 

27# 




OSKIO 

40# 




EXCOM 

54# 




INT20 

22# 

120 



INT21 

22# 

125 



INT24 

23# 

139 



IHT25 

23# 

143 



INT2S 

24# 

147 



IIIT27 

24# 

151 



KDP 

61# 




KSP ... 

62# 




PRNDP 

64# 




PRNP 

66# 




PROFILE 

36# 




R100 

20 

9 1 

1 69# 


R100A 

82 

96# 



RE INIT 

20 

74# 

1 72 


ROM 

57# 




SKIP 

93 

156# 



SPARE41 

SO# 




SPARE42 

51# 




UART 

55# 




VERT 

49# 




WPRSNT 

70# 




XCPRSNT 

71# 




XOPTION 

20 

1 70# 



280 

56# 
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1 



PAGE 

60,132 


2 



TITLE 

Disk def i n i t i on 

ables for MSDOS 2.00 

3 

4 



NAME 

DSKTBL 


5 

6 



COMPANY CONFIDENTIAL 


7 



; Copyright (C) 1983 Digital Equipment Corporation 

6 

g 



; All rights reserved. 


10 



' 



1 1 



cgroup group 

code 


1 2 

OOOO 


code segment 

byte public 'code' 


1 3 



assume cs : cgr oup . ds : cgr oup 


1 4 






1 5 



public dsKtbl , inittbl 


1 6 



extrn decdisk:near : ; . serdsi 

: near 

1 7 



; 



1 8 



;Oefine the disk data block used 

by the BIOS. 

1 9 



; 



20 



dskbik macro 

bpbp , dchk . drvr , ct rk 

sec si z , spt , dens , drv , dtr k , gp 1 , enn , dt 1 

2 1 



dw 

bpbp 

BPB ptr. 

22 



dw 

dchk 

1: fixed dsk. 

23 



dw 

drvr 

dr i ver addr , 

24 



dw 

ct r k 

curr t r k ptr. 

25 



dw 

secs i z 

sector size. 

26 



dw 

spt 

sector s/trk , 

27 



dw 

dens .-density 

0«RX 1SIBM6 2SIBM9 

28 



dw 

dr V 

drive # , 

29 



dw 

dt rk 

dens, chk trk 

30 



dw 

gpl 

765 gap len, 

3 1 



dw 

enn 

765 N, 

32 



dw 

dt 1 

765 data len. 

33 






34 



endm 



35 






36 



;Create a BPB 

block for the system. 

37 






38 



bpb macro secs i z , c 1 ss i z . r essec . f at s . d i r s . dsks i z , road i a , spf 

39 



dw 

secs i z 

sector size. 

40 



db 

c Issi z 

cluster size. 

4 1 



dw 

r essec 

resv'd sectors 

42 



db 

fats 

# FATS, 

43 



dw 

d i r s 

# d i r s , 

44 



dw 

dsksi z 

total sectors, 

45 



db 

media 

media byte. 

46 



dw 

spf 

sectors/FAT , 

47 






46 



endm 
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PACE 


1 -2 
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49 



page 

60 





61 




Initialization table. Merely a set of 

62 




pointers, one per unit, to the largest 

63 




BPB for that unit. 

64 





65 

oooo 

04 

inittbl db 4 

66 

0001 

004C 

R 

dw bpbdec 

67 

0003 

004C 

R 

dw bpbdec 

68 

0006 

004C 

R 

dw bpbdec 

58 

0007 

004C 

R 

dw bpbdec 

60 




dw bpbibm .DEBUG 

61 





62 




BIOS internal data tables. These define all 

63 




physical characteristics and current format 

64 




for each drive. The first byte is the number 

65 




of dr i ves . 

66 





67 

0009 

04 

dsktbl db 4 ;# disks. 

66 

OOOA 

0012 

R 

dw diska 

69 

OOOC 

00 1 A 

R 

dw diskb 

70 

OOOE 

0022 

R 

dw diskc 

71 

O010 

002A 

R 

dw diskd 

72 




dw diskx ; DEBUG 

73 





74 




For each unit there are three alternative 

76 




formats. This table defines the three format; 

76 




for each drive, and pointer to the byte va1u( 

77 




that tells which to use. 

76 





79 




.’diskx dw dmibma 

80 




dw dm i bma 

61 




dw currx 

82 





83 

0012 

0069 

R diska dw deca 

84 

0014 

OOB9 

R 

dw i bma 

86 

0016 

0119 

R 

dw ibm9a 

86 

0018 

018 1 

R 

dw curra 

67 





68 

001 A 

0071 

R diskb dw decb 

89 

00 1C 

OOD1 

R 

dw i bfflb 

90 

00 1E 

013 1 

R 

dw ibmSb 

9 1 

0020 

0182 

R 

dw currb 

92 





93 

0022 

0089 

R diskc dw decc 

94 

0024 

OOE9 

R 

dw i bmc 

95 

0026 

0149 

R 

dw ibm9c 

96 

0028 

0183 

R 

dw curre 

97 





98 

002A 

OOA1 

R diskd dw deed 

99 

002C 

0101 

R 

dw i bmd 

100 

002E 

0161 

R 

dw ibmSd 

101 

0030 

0184 

R 

dw currd 
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102 

103 

104 
10B 
106 

107 

108 
108 
1 10 
1 1 1 
112 
113 
1 1 4 
116 
1 1 6 
1 17 
1 18 

119 

120 
121 
122 

123 

124 
126 
126 

127 

128 

129 

130 

131 

132 

133 

134 
136 

136 

137 

138 

139 

140 

141 

142 

143 

144 
146 


These tables describe each logical drive's 
physical charact er 1 st ics . Each logical disk 
has a table entry. 

ATTENTION the fat id byte for each table 
must be different. 


0032 

0032 

0034 

0036 

0037 

0038 
003A 
003C 
0030 
003F 
003F 

0041 

0042 
0044 

0046 

0047 
0049 
004A 
004C 
004C 
004E 
O04F 
006 1 
0062 
0064 
006 6 
0067 


0200 

01 

0001 

02 

0040 

0140 

FE 

0001 

0200 

01 

0001 

02 

0040 

0168 

FC 

0002 

0200 

01 

0014 

02 

0060 

0320 

FA 

0003 


bpbibm: bpb 
dw 
db 
dw 
db 
dw 
dw 
db 
dw 

bpbf bm9 : bpb 
dw 
db 
dw 
db 
dw 
dw 
db 
dw 

bpbdec : bpb 
dw 
db 
dw 
db 
dw 
dw 
db 
dw 


5 12 . 1 . 

612 


64 

8*40 
Of eh 
1 

5 12.1, 
5 1 2 
1 
1 
2 

64 

9*40 

Of ch 
2 

5 12,1, 
512 
1 

2*10 

2 

96 

80*10 

Ofah 

3 


1.2. 64,8*40,Ofeh, 1 

sector size, 
c 1 uster size, 
resv'd sectors 

# FATS, 

# dirs, 

total sectors, 
media byte, 
sectors/FAT . 
1,2, 64.9*40.Ofch, 2 

sector size, 
c 1 ust er size, 
resv'd sectors 

# FATS. 

# dirs. 

total sectors, 
media byte, 
sect or s/FAT . 
2*10,2.96.80* 10. Ofah, 3 
sector size, 
c 1 ust er size, 
resv'd sectors 

# FATS, 

# dirs. 

total sectors, 
media byte, 
sectors/FAT , 


Density here is: 


This 
I f O 


0 sc RX-60 

1 St I8M 8 sectors 

2 ss IBM 9 sectors or (Robin) 

is used by the 280 for 80/40 track switch, 
then 80 tracks, else 40 tracks. 


146 

0069 


deca : 

dskbik 

bpbdec . 0 , 

, deedi sk , t racka . 6 1 2 , 1 ( 

147 

0069 

004C R 

♦ 

dw 

bpbdec 

;8P6 ptr. 

148 

006B 

OOOO 

♦ 

dw 

O 

: 1 1 fixed dsk 

149 

0060 

OOOO E 

+ 

dw 

deedi sk 

: dr i ver addr . 

160 

006F 

0179 R 

♦ 

dw 

t racka 

;curr trk ptr 

161 

0061 

0200 

♦ 

dw 

612 

;sector size. 

162 

OOB3 

OOOA 

4 

dw 

10 

; sacters/trk. 

163 

OOB5 

OOOO 

♦ 

dw 

0 

; density: 0>RX 1sI8M8 

164 

0087 

OOOO 

♦ 

dw 

0 

;drive #. 

166 

0068 

0002 

♦ 

dw 

2 

;dens. ehk tri 

166 

0088 

OOOO 

♦ 

dw 

O 

;7B6 gap len. 


, 0 . 2 . 0 , 0.0 


IBM9 
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i -♦ 


1S7 

006D 

OOOO 


+ 

dw 

0 

765 N . 

156 

006P 

OOOO 


♦ 

dw 

o 

765 data len, 

159 

007 1 



decb : 

dsKbIk 

bpbdec , O . deed i sk 

trackb,5l2. 10.0. 1 .2.0.0.0 

1 60 

0071 

004C 

R 

+ 

dw 

bpbdec 

8P8 ptr. 

161 

0073 

OOOO 


+ 

dw 

O 

1 e f i xed dsk . 

1 62 

0075 

OOOO 

E 

♦ 

dw 

deed i sk 

driver addr . 

1 63 

0077 

017A 

R 

♦ 

dw 

t rackb 

curr trk ptr. 

1 64 

0079 

0200 


■f 

dw 

512 

sector size. 

1 65 

0076 

OOOA 


+ 

dw 

10 

sect or s/t r k . 

166 

0070 

OOOO 


+ 

dw 

0 .density 

1 

0*RX 1:IBM8 2sI6M9 

1 67 

007F 

0001 


+ 

dw 

drive # . 

1 68 

008 1 

0002 


♦ 

dw 

2 

dens. chK trk 

1 69 

0083 

OOOO 


♦ 

dw 

O 

765 gap len. 

170 

0085 

OOOO 


♦ 

dw 

0 

765 N. 

171 

0087 

OOOO 


+ 

dw 

0 

765 data len. 

172 

0089 



dace : 

dskbik 

bpbdec , O . deed i sk 

trackc.512. 10.0.2.2.0.0.0 

173 

0089 

004C 

R 

♦ 

dw 

bpbdec 

6P6 ptr. 

174 

0086 

OOOO 


+ 

dw 

0 

1= fixed dsk. 

1 75 

0080 

OOOO 

E 

+ 

dw 

deed i sk 

dr i ver addr . 

176 

008F 

0176 

R 

+ 

dw 

t rackc 

curr trk ptr. 

1 77 

009 1 

0200 


* 

dw 

512 

sector size. 

178 

0093 

OOOA 


* 

dw 

10 

sect or s/t r k , 

179 

0095 

OOOO 


* 

dw 

0 :density 

0:RX 1:I6M8 2 s I 6M9 

1 80 

0097 

0002 


+ 

dw 

2 

drive # , 

1 8 1 

0099 

0002 


♦ 

dw 

2 

dens, chk trk 

182 

0096 

OOOO 


+ 

dw 

0 

765 gap len. 

183 

0090 

OOOO 


♦ 

dw 

0 

765 N . 

184 

009F 

OOOO 


+ 

dw 

0 

765 data len. 

185 

OOA1 



deed : 

dskbik 

bpbdec , O . deed i sk 

tr ackd, 512. 10,0,3.2.0.0.0 

186 

OOA1 

004C 

R 

+ 

dw 

bpbdec 

8P8 ptr. 

1 87 

OOA3 

OOOO 


+ 

dw 

o 

1 = f i xed dsk , 

1 88 

OOA5 

OOOO 

E 

♦ 

dw 

deed i sk 

driver addr , 

1 89 

OOA7 

01 7C 

R 

+ 

dw 

t r ackd 

curr trk ptr. 

190 

OOA9 

0200 


+ 

dw 

5 1 2 

sector size. 

19 1 

OOA8 

OOOA 


+ 

dw 

10 

sect or s/t r k , 

192 

OOAO 

OOOO 


+ 

dw 

O ;density 

0:RX 1:I6M8 2*I6M9 

193 

OOAF 

0003 


+ 

dw 

3 

drive # , 

194 

006 1 

0002 


+ 

dw 

2 

dens, chk trk 

195 

0063 

OOOO 


+ 

dw 

O 

765 gap len. 

196 

0065 

OOOO 


+ 

dw 

O 

765 N . 

197 

0087 

OOOO 


+ 

dw 

O 

765 data len. 

198 








199 

0069 



i bma : 

dskbik 

bpbi bm , O . deed i sk . 

,tracke,512, 8 , 2 . 0 , O , 0 , 0 , 0 

200 

0069 

0032 

R 

+ 

dw 

bpbi bm 

8P8 ptr. 

201 

0086 

OOOO 


+ 

dw 

O 

1 : f i xed dsk , 

202 

0060 

OOOO 

E 

+ 

dw 

deed i sk 

dr i ver addr , 

203 

006F 

0170 

R 

♦ 

dw 

t r acke 

curr trk pt r , 

204 

OOC 1 

0200 


♦ 

dw 

5 1 2 

sector size. 

205 

OOC3 

0008 


+ 

dw 

8 

sect ors/trk , 

206 

0OC5 

0002 


♦ 

dw 

2 ;density 

ObRX 1:1BM8 2:I6M9 

207 

OOC7 

OOOO 


♦ 

dw 

0 

drive # , 

208 

OOC9 

OOOO 


+ 

dw 

O 

dens, chk trk 

209 

OOC6 

OOOO 


♦ 

dw 

O 

765 gap len. 

210 

OOCO 

OOOO 


♦ 

dw 

0 

765 N , 

21 1 

OOCF 

OOOO 


+ 

dw 

O 

765 data len, 
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2 1 2 

OOD 1 




i bmb : 

dskbik 

bpbi bm. O 

,decdisk,trackf,512, 8,2, 1,0, 0,0,0 

213 

OOD 1 

0032 

R 

♦ 


dw 

bpbi bm 

; 8P6 ptr. 

214 

0003 

OOOO 


+ 


dw 

0 

; 1 s f i xed dsk , 

2 1 5 

0005 

OOOO 

E 

♦ 


dw 

deed i sk 

; dp i ver addr . 

216 

0007 

01 7E 

R 

♦ 


dw 

t r ack f 

; cur r trk ptr. 

217 

0009 

0200 


■f 


dw 

5 1 2 

; sect or size. 

2 1 8 

0006 

0008 


♦ 


dw 

8 

; sect ors/trk. 

219 

OOOO 

0002 


+ 


dw 

2 

;density: OiRX 1sI6M8 2 cIBM9 

220 

OODF 

0001 


+ 


dw 

1 

; dr i ve # , 

221 

OOE 1 

OOOO 


♦ 


dw 

0 

; dens . chk trk 

222 

OOE3 

OOOO 


♦ 


dw 

0 

; 765 gap 1 en , 

223 

OOE5 

OOOO 


+ 


dw 

o 

;765 N, 

224 

OOE7 

OOOO 


+ 


dw 

o 

;765 data len. 

225 

OOE9 




i bmc . 

dskbik 

bpbi bm , O 

.decdisk.trackg, 512, 8, 2, 2, 0,0, 0,0 

226 

OOE9 

0032 

R 

+ 


dw 

bpbi bm 

; BP6 ptr , 

227 

OOE6 

OOOO 


+ 


dw 

o 

; 1 s f i xed dsk , 

228 

OOED 

OOOO 

E 

+ 


dw 

deed i sk 

; dr i ver addr , 

229 

OOEF 

017F 

R 

+ 


dw 

t r ackg 

; curr trk pt r , 

230 

OOF 1 

0200 


♦ 


dw 

512 

;sector size. 

231 

OOF3 

0008 


+ 


dw 

8 

; sect or s/t r k , 

232 

OOF5 

0002 


+ 


dw 

2 

;density: 0«RX 1 s I BM8 2 bIBM9 

233 

OOF7 

0002 


♦ 


dw 

2 

.'drive # , 

234 

OOF9 

OOOO 


+ 


dw 

O 

;dens. chk trk 

235 

OOF8 

OOOO 


+ 


dw 

O 

: 765 gap 1 en , 

236 

OOFD 

OOOO 


+ 


dw 

o 

;765 N, 

237 

OOFF 

OOOO 


+ 


dw 

o 

;765 data len. 

238 

0101 




i bmd : 

dskbik 

bpbi bm, 0 

. deed isk.trackh.512, 8, 2, 3. 0,0, 0.0 

239 

0101 

0032 

R 

+ 


dw 

bpbi bm 

:BP6 ptr. 

240 

0103 

OOOO 


♦ 


dw 

0 

; 1 B f ixed dsk , 

241 

0105 

OOOO 

E 

+ 


dw 

deed i sk 

.'driver addr. 

242 

0107 

0180 

R 

+ 


dw 

t rackh 

; curr trk pt r . 

243 

0109 

0200 


♦ 


dw 

512 

; sect or size. 

244 

0106 

0008 


+ 


dw 

8 

; sect ors/trk , 

245 

010D 

0002 


+ 


dw 

2 

;density: 0*RX 1*IBM8 2*IBM9 

246 

010F 

0003 


+ 


dw 

3 

;drive #, 

247 

0111 

OOOO 


+ 


dw 

O 

;dens. chk trk 

248 

0113 

OOOO 


•f 


dw 

O 

;765 gap len. 

249 

0115 

OOOO 


♦ 


dw 

o 

;765 N, 

250 

0117 

OOOO 


♦ 


dw 

0 

;765 data len. 

251 









252 

0119 




i bm9a : 

dskbik 

bpbi bra9 . 

0 , deedi sk ,tr acke. 512. 9, 2. 0,0, 0,0,0 

253 

0119 

003F 

R 

♦ 


dw 

bpbi bm9 

;BPB ptr. 

254 

0116 

OOOO 


+ 


dw 

O 

; 1 B fixed dsk . 

255 

0110 

OOOO 

E 

♦ 


dw 

deed i sk 

; dr i ver addr . 

256 

01 IF 

0170 

R 

♦ 


dw 

t racke 

; curr trk ptr. 

257 

012 1 

0200 


+ 


dw 

512 

;sector size. 

258 

0123 

0009 


+ 


dw 

9 

; sect ors/trk , 

259 

0125 

0002 


♦ 


dw 

2 

;density: ObRX 1bIBM8 2bIBM9 

260 

0127 

OOOO 


+ 


dw 

O 

;drive #, 

261 

0129 

OOOO 


♦ 


dw 

0 

;dens. chk trk 

262 

0126 

OOOO 


♦ 


dw 

0 

;765 gap len. 

263 

0120 

OOOO 


+ 


dw 

0 

;7B5 N, 

264 

012F 

OOOO 


+ 


dw 

o 

;785 data len. 

265 

0131 




ibraSb; 

dskbik 

bpbi bm9 , 

O. deed isk.trackf .512,9, 2. 1 , 0 . 0 , 0.0 

266 

0131 

003F 

R 

+ 


dw 

bpbibm9 

;BPB ptr. 
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267 

0133 

OOOO 

+ 

dw 

0 

is fixed dsk. 

268 

0135 

OOOO E 

4 ' 

dw 

deed i sk 

dr i ver addr , 

269 

0137 

017E R 

♦ 

dw 

trackf 

curr trk ptr , 

270 

0139 

0200 

♦ 

dw 

512 

sector size, 

271 

0136 

0009 

4 

dw 

9 

sector s/t r k , 

272 

0130 

0002 

4 

dw 

2 ;density 

OsRX 1tI8M6 2SIBM9 

273 

013F 

0001 

4 

dw 

1 

drive # . 

274 

014 1 

OOOO 

4 

dw 

0 

dens- chk trk 

275 

0143 

OOOO 

4 

dw 

0 

765 gap len. 

276 

0145 

OOOO 

4 

dw 

0 

765 N . 

277 

0147 

OOOO 

4 

dw 

0 

765 data len. 

278 

0149 



ibm9c: dskbik 

bpb i bm9 , O , deed i si 

i, trackg, 512, 9, 2. 2, 0,0, 0,0 

279 

0149 

003F R 

4 

dw 

bpbi bm9 

BP6 ptr. 

280 

0146 

OOOO 

4 

dw 

0 

is fixed dsk. 

28 1 

0140 

OOOO E 

4 

dw 

deed i sk 

dr i ver addr , 

282 

014F 

01 7F R 

4 

dw 

trackg 

curr trk ptr , 

283 

015 1 

0200 

4 

dw 

512 

sector size. 

284 

0153 

0009 

4 

dw 

9 

sectors/trk. 

285 

0155 

0002 

4 

dw 

2 ; dens i t y 

OsRX 1SIBM8 2SIBM9 

286 

0157 

0002 

4 

dw 

2 

drive # , 

287 

0159 

OOOO 

4 

dw 

0 

dens, chk trk 

288 

0156 

OOOO 

4 

dw 

0 

765 gap len, 

289 

0150 

OOOO 

4 

dw 

0 

765 N . 

290 

01 5F 

OOOO 

4 

dw 

0 

765 data len. 

29 1 

016 1 



ibm9d; dskbik 

bpb i bmS , 0 , deed i st 

(.trackh, 512, 9, 2, 3, 0,0, 0,0 

292 

0161 

003F R 

4 

dw 

bpbi bm9 

BPB ptr. 

293 

0163 

OOOO 

4 

dw 

0 

1 : fixed dsk , 

294 

0165 

OOOO E 

4 

dw 

deed i sk 

driver addr , 

295 

O 1 67 

0180 R 

4 

dw 

trackh 

curr trk ptr. 

296 

O 1 69 

0200 

4 

dw 

512 

sect or size. 

297 

O 1 66 

0009 

4 

dw 

9 

sect or s/ 1 r k , 

298 

O 1 60 

0002 

4 

dw 

2 ;density 

OsRX 1SIBM8 2SIBM9 

299 

01 6F 

0003 

4 

dw 

3 

drive # , 

300 

017 1 

OOOO 

4 

dw 

0 

dens, chk trk 

30 1 

0173 

OOOO 

4 

dw 

0 

765 gap len. 

302 

0175 

OOOO 

4 

dw 

0 

765 N , 

303 

0177 

OOOO 

4 

dw 

0 

765 data len. 

304 







305 




; ; dm i bma : 

dskbik bpbibm,- 

1 ,serdsk,trackx,5l2,8,3, 1 ,0,0, 0,0 
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306 

307 
306 

309 

310 
3 1 1 
3 1 2 
3 1 3 
314 
3 15 

316 

317 

318 

319 

320 

321 

322 

323 

324 

325 

326 

327 

328 

329 

330 

331 

332 

333 

334 

335 

336 

337 

338 

339 

340 


0179 FF 
017A FF 
0176 FF 
017C FF 

017D FF 
017E FF 
017F FF 

0180 FF 


0181 OO 

0182 OO 

0183 OO 

0184 OO 


0185 


page 

;Current tracks. The current track is kept 
; f or each PHYSICAL drive; note that the tables 
; above that use the same physical drive point 
;to the same current track. No need to fiddle 
,-with these, except maybe to add one if more 
;drives are added. 

tracka db 255 : same drives as 

trackb db 255 ;be1ow. but different 

trackc db 255 ; number of tracks, 

trackd db 255 

tracke db 255 

trackf db 255 

trackg db 255 

trackh db 255 

; ; t rackx db 255 

; Current format selections. One per logical 
;drive. These get updated by the media check 
;disk call, to either 0,1 or 2. 

curra db 0 

currb db O 

currc db 0 

currd db O 

; ; cur r X db O 

code ends 


end 
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Macros : 













N 

a 

ffl 

e 

Length 




■PB . . . 






0006 




DSKBLK . 






0009 




Segments 

and groups: 










N 

a 

ro 

e 

S i se 

align 

combine 

class 

CGROUP . 






GROUP 




CODE . 






0185 

BYTE 

PUBLIC 

'CODE' 

Symbols : 













N 

a 

m 

e 

Type 

Value 

Att r 


BPBOEC . 






L 

NEAR 

0O4C 

CODE 


BPBIBM . 






L 

NEAR 

0032 

CODE 


BPBIBM9 . 






L 

NEAR 

003F 

CODE 


CURRA. . 






L 

BYTE 

0181 

CODE 


CURRB. . 






L 

BYTE 

0182 

CODE 


CURRC. . 






L 

BYTE 

0183 

CODE 


CURRO. . 






L 

BYTE 

0184 

CODE 


DECA . . 






L 

NEAR 

0059 

CODE 


DECB . . 






L 

NEAR 

007 1 

CODE 


DECC . . 






L 

NEAR 

0089 

CODE 


OECD . . 






L 

NEAR 

OOA1 

CODE 


DECDISK . 






L 

NEAR 

OOOO 

CODE 

Ext er na 1 

DISKA. . 






L 

WORD 

0012 

CODE 


DISKB. . 






L 

WORD 

001 A 

CODE 


DISKC. . 






L 

WORD 

0022 

CODE 


DISKO. . 






L 

WORD 

002A 

CODE 


OSKTBL . 






L 

BYTE 

0009 

CODE 

Global 

IBM9A. . 






L 

NEAR 

0119 

CODE 


IBM9B. . 






L 

NEAR 

0131 

CODE 


IBM9C. . 






L 

NEAR 

0149 

CODE 


IBM9D. . 






L 

NEAR 

0161 

CODE 


IBMA . . 






L 

NEAR 

OOB9 

CODE 


IBMB . . 






L 

NEAR 

OOD 1 

CODE 


I BMC . . 






L 

NEAR 

OOE9 

CODE 


IBMO . . 






L 

NEAR 

0101 

CODE 


INITTBL . 






L 

BYTE 

OOOO 

CODE 

Globa 1 

I TRACKA . 






L 

BYTE 

0179 

CODE 


TRACKS . 






L 

BYTE 

01 7A 

CODE 


TRACKC . 






L 

BYTE 

01 7B 

CODE 


TRACKD . 






L 

BYTE 

01 7C 

CODE 


TRACKS . 






L 

BYTE 

0170 

CODE 


TRACKS . 






L 

BYTE 

01 7E 

CODE 


TRACKC . 






L 

BYTE 

017F 

CODE 


TRACKH . 






L 

BYTE 

0180 

CODE 


Warn i ng 

Severe 










Errors 

Errors 
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[# is def init ion) 

BPB 

1 10 

1 1 9 

128 


BPBDEC 

56 

57 

58 

59 

BPBIBM 

1 10# 

200 

2 1 3 

226 

BPB IBM9 

1 1 9# 

253 

266 

279 

CGROUP 

1 1 

1 3 

13 


CODE 

1 1 

1 2# 

1 2 

338 

CURRA 

8 6 

331# 



CURRB 

9 1 

332# 



CURRC 

96 

333# 



CURRD 

101 

334# 



DECA 

83 

146# 



DECB 

88 

1 59# 



DECC 

93 

1 72# 



DECD 

98 

1 85# 



DECD ISK 

1 6# 

1 49 

1 62 

1 75 

D ISKA 

68 

83# 



D ISKB 

69 

88# 



D ISKC 

70 

93# 



D ISKD 

7 1 

98# 



DSKBLK 

146 

1 59 

172 

185 

DSKTBL 

1 5 

67# 



I BM9A 

85 

252# 



IBM9F. 

90 

265# 



I BM9C 

95 

278# 



1 BM9D 

1 00 

29 1 # 



IBMA 

64 

199# 



IBMB 

89 

2 1 2# 



I BMC 

94 

225# 



IBMD 

99 

238# 



INITTBL 

1 5 

55# 




Cref - 1 

12ft# 147 160 173 1ft6 

239 

292 


Iftft 202 215 226 241 255 266 281 


199 212 225 238 252 265 276 291 


TRACKA 

TRACKS 

TRACKC 

TRACKO 

TRACKE 

TRACKF 

TRACKG 

TRACKH 


150 315# 

163 316# 

176 317# 

189 318# 

203 256 320# 

216 269 321# 

229 282 322# 

242 295 323# 
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60,132 

MSDOS 2.00 Universal Disk driver 
DISK 


COMPANY CONFIDENTIAL 

Copyright (C) 1963 Digital Equipment Corporation 

All rights reserved. 


10/05/83 
cgroup group code 


public dsk, MC^FLG 
public cffldstr, dsktmr 


ext r n 
ext r n 


pt r sav e : dwor d 

dsktbl -.word, inittbl :word 


0064 
002C 

0065 


This is a special version for the Rainbow. 

It prevents disk access outside the range 
of 01000 - Offffh. Much optimization has 
been done to speed things up. 

include iodef.ash 
Rainbow Interrupt numbers. 

1 -Apr-63 sgs added dskio i nt vector 

19-Mar-83 sgs added profile int vector [user clock] 

the int profile is called by the RTC interrupt service for each tick. 
The ax and ds register don't need to be saved [done in clkisr]. 

profile equ 64h ; 1 OO . user interface to clock interrupt 

clk__int equ 2ch ; 60Hz int, 

dskio equ 65h .‘direct disk io for format 


17-Mar-83 sgs changed to include int 20-26 

interrupt 22-24h are duplicated at 42-44h for consistency. 
These are the relocated Rainbow interrupts, 
i nt c 


40 



C 

;ATTENTION Modul 

es lOINIT and REINIT may have t 

4 1 



c 

; changed 

if int 

vect or s 

40h to 46h are changed 

42 



c 




43 

= 

0040 

c 

vert 

equ 

40h 

; new vert . f req . 

44 

r 

004 1 

c 

spar e4 1 

equ 

4 1 h 

45 

= 

004 2 

c 

spar e42 

equ 

42h 


46 

= 

0043 

c 

comdraa 

equ 

43h 

; DMA Ctrl optional comm 

47 

= 

0044 

c 

aux__pr n 

equ 

44h 

;7201 comm . /pr i nt er 

48 

s 

0045 

c 

excom 

equ 

45h 

; ext anted comm, option 

49 

= 

0046 

c 

uar t 

equ 

46h 

; new UART vector. 

50 

* 

0047 

c 

280 

equ 

47h 

; 280 i nt er r upt . 

5 1 

* 

0018 

c 

r om 

equ 

1 8h 

; new ROM access. 


;DEC Ra i nbow ID pert stuff. 


294 


0010 


C kdp 


equ 


tOh 


.‘8251 data port. 
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56 = 0011 C Ksp equ 11h ;8251 status. 

57 = 0040 C auxdp equ 40h ;7201 data, 

58 : 0041 C prndp equ 41h 

59 : 0042 C auxp equ 42h ;7201 command, 

60 = 0043 C prnp equ 43h 

6 1 C ; 

62 C : Values in XOPTION 

63 C 

64 sOOOl C wprsnt equ 01 ;Winniepreset 

65 : 0002 C xcprsnt equ 02 ; XCOMM present 

66 

67 extrn bufferrnear ;defined in END . ASM 

68 

69 OOOO code segment byte public 'code' 

70 assume c s : cgr oup , ds : c gr oup 

71 ; 

72 High level disk interface for MSDOS 

73 ; 2 . OO . The MSDOS request for N logical sectors 

74 ;is broken down to a bunch of calls to the 

75 ;phsical driver to do sectors within a given 

76 ;physical track. Address wrap around due to 

77 ;hardware limitations (16 bit address, 4 bit 

78 ;page register) is taken care of here, as well 

79 ;as I/O requests larger than 64K bytes that 

60 ;would wrap around a segment. 

8 1 

82 C include ms2O0 . ash 

83 C 

84 C ;MSDOS 2.00 10 device data packet layout. 

85 C 

86 C iodata struc 

87 OOOO ?7 C cmdien db (?) ; packet length, 

88 OOO 1 ?? C unit db (?) ;unit number, 

89 0002 ?? C cmd db (?) ; command. 

90 0003 ???? C status dw (?) ;returned status, 

91 0005 08 [ C db 8 dup (?) 

92 ?? C 

93 ] C 

94 C 

95 OOOD ?? C media db (?) ;descriptor byte 

96 OOOE ???????? C trans dd (?) ;transfer address 

97 0012 ???? C count dw (?) ;data count 

98 0014 ???? C start dw (?) , -Starting record 

99 0016 C iodata ends 

100 C 
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MSDOS 

101 

102 

2.00 Universal Disk driver 
= OOOO 

page 
f wr i t e 

equ 

0 

write 

103 

= 0001 


f read 

equ 

1 

r ead 

104 

s 0002 


f dens 

equ 

2 

check dens i ty 

105 

= 0003 


f wr i t Gv 

equ 

3 

write with verify 

106 

: 0065 


dskdr ct 

equ 

06Sh 

direct disk access interrupt 

107 

s 0002 


tmr cnt 

equ 

2 

2 sec . t i meout 

108 
109 
1 10 
1 1 1 
1 1 2 
1 1 3 
1 1 4 
1 1 5 
1 1 6 

OOOO 

OOOO 

? ? 

; Phys i ca 1 disk 
;read or write 
; a po i nt er to i 
; dr i V er . 

cmd St r : 
command db 

driver par 
command i 
t is pass< 

( ? ) 

ameter block. The 
bu i 1 t here, and 
»d to the act ua 1 

floppy command. 

1 1 7 

OOO 1 

? ? 

dskdr V 

db 

( ? ) 

disk drive. 

1 1 8 

0002 

?? 

track 

db 

( ? ) 

seek track. 

1 1 9 

0003 

?? 

physec 

db 

( 7 ) 

seek sect or , 

1 20 

0004 

?? 

physcnt 

db 

( 7 ) 

sect or count , 

1 2 1 

0005 

? ? 

cur t r k 

db 

( 7 ) 

current track, 

122 

0006 

?? 

dens i t y 

db 

( 7 ) 

density/size flag. 

1 23 

0007 

? ? 

gap 1 en 

db 

( 7 ) 

766 gap length. 

1 24 

0008 

?? 

enn 

db 

( 7 ) 

765 sec size. 

1 25 

0009 

7 ? 

dt 1 

db 

( 7 ) 

765 data length, 

126 

OOOA 

???? 

secs i 2 

dw 

( 7 ) 

sect or size. 

1 27 

oooc 

? ? ? ? 

dskof f 

dw 

( 7 ) 

DMA off set , 

1 28 

OOOE 

???? 

dskseg 

dw 

(7) 

DMA segment , 

129 

130 

131 

132 

133 

0010 

?? 

;End of the command stri 
; i nt or na 1 st uf f . 

dr i vor db ( ? ) 

ig, start of 
dr i vor number , 

134 

OO 1 1 

? ? ? ? 

trkptr 

dw 

(7) 

pt r to current track. 

135 

0013 

? ?? ? 

bpbpt r 

dw 

( 7 ) 

ptr to BPB, 

136 

001 5 

???? 

typptr 

dw 

( 7 ) 

pt r to current format. 

137 

00 17 

? ? 

chkbyt e 

db 

( 7 ) 

1 if non removable. 

138 

001 8 

7 ? 

dent r k 

db 

( 7 ) 

trk for density test. 

139 

001 9 

???? 

spt 

dw 

( 7 ) 

sectors per track. 

1 40 

0016 

???? 

scount 

dw 

( 7 ) 

physical sector count. 

141 

001 D 

?? 

er rmsk 

db 

( 7 ) 

status mask. 

142 

001 E 

???? 

ca 1 1 addr dw 

( 7 ) 

driver address. 

143 

0020 

???? 

dmaof f 

dw 

( 7 ) 

DMA of f set , ( don ' t change these DMA order) 

144 

0022 

7 7 7 7 

dmaseg 

dw 

( 7 ) 

DMA segment , 

145 

0024 

???? 

sect or 

dw 

( 7 ) 

MSDDS sector number. 

146 

0026 

???? 

numsec 

dw 

( 7 ) 

MSDOS sector count. 

147 

148 

0028 

FF 

tmrdr V 

db 

Of f h 

; Last drive used successfully 

149 

0029 

02 

dskt mr 

db 

tmrcnt 

; t i mer 1 oc . 
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150 



page 


15 1 





152 



; D i sk f unct i on 

for the BIOS. 

153 





154 

002A 


dsk : 


155 

002A 


dispatch proc 

far 

156 

002A 

9C 

pushf 


157 

002B 

50 

push 

ax 

158 

O02C 

53 

push 

bx 

159 

002D 

5 1 

push 

cx 

1 50 

O02E 

52 

push 

dx 

1 6 1 

002F 

56 

push 

S i 

1 62 

0030 

57 

push 

d i 

163 

003 1 

55 

push 

bp 

164 

0032 

1 E 

push 

ds 

165 

0033 

06 

push 

es 

166 

0034 

OE 

push 

cs 

167 

0035 

1 F 

pop 

ds 

1 68 

0036 

2E: C4 IE OOOO E 

1 es 

bx , cs : pt r save 

1 69 

003B 

26: 80 7F 02 OO 

cmp 

esrbyte ptr [bx.cmd],0 ;Init call? 

1 70 

0040 

74 01 

je 

noint ;Don't enable i nt s on INIT 

1 7 1 

0042 

FB 

st i 


172 

0043 

26. C7 47 03 OOOO 

no i nt : mov 

word ptr es : [ bx . st at us 1 , O 

173 

0049 

26: 8A 47 01 

mov 

a 1 . es : [ bx . un i t ] 

174 

O04D 

A2 0010 R 

mov 

dr i ver , a 1 

175 

0050 

26 : 8B 47 12 

mov 

ax.es: [ bx . count ] 

176 

0054 

A3 0026 R 

mov 

numsec , ax 

177 

0057 

26: 8B 47 14 

mov 

ax , es : [ bx . st ar t ] 

178 

O05B 

A3 0024 R 

mov 

sect or , ax 

179 

005E 

26: 8B 47 OE 

mov 

ax, word ptr es : ( bx . t r ans ] 

160 

0062 

A3 0020 R 

mov 

dmaof f , ax 

1 8 1 

0065 

26: 8B 47 10 

mov 

ax. word ptr es : t bx . t r ans t 2 ] 

182 

0069 

A3 0022 R 

mov 

dmaseg , ax 

163 

006C 

26 ; 8A 5F 02 

mov 

b 1 , es : ( bx . cmd } 

184 

0070 

80 FB OC 

cmp 

b1 . 1 2 ; check i n 

165 

0073 

76 02 

j be 

cmdok ; range, bound 

186 

0075 

B3 OD 

mov 

b1 , 1 3 ; it , 

187 

0077 

B7 OO 

cmdok : mov 

bh , O 

188 

0079 

D 1 E3 

sh 1 

bx , 1 

189 

007B 

81 C3 OOAC R 

add 

bx, offset dtbl 

190 

007F 

FF 1 7 

ca 1 1 

word ptr t bx 1 

1 9 1 

008 1 

2E C5 IE OOOO E 

Ids 

bx , cs : pt r save ; set DONE, 

192 

0086 

81 4F 03 0100 

or 

word ptr [ bx . st at us ] , 1 OOh 

193 

008B 

07 

pop 

es 

194 

008C 

1 F 

pop 

ds 

195 

008D 

5D 

pop 

bp 

1 9 6 

008E 

5F 

pop 

d i 

197 

008F 

5E 

pop 

S i 

1 9 8 

0090 

5A 

pop 

dx 

199 

009 1 

59 

pop 

cx 

200 

0092 

5B 

pop 

bx 

20 1 

0093 

58 

pop 

ax 

202 

0094 

9D 

popf 


203 

0095 

CB 

r et 


204 

0096 


dispatch endp 
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205 

206 

207 

208 


20S 0096 

210 009B 

2 1 1 OOAO 

212 

213 

214 

215 OOA1 

216 OOA6 

217 OOAB 
2 1 8 

219 OOAC 

220 OOAE 

221 OOBO 

222 OOB2 

223 OOB4 

224 OOB6 

225 OOB8 

226 OOBA 

227 OOBC 

228 OOBE 

229 OOCO 

230 00C2 

231 OOC4 

232 

233 


2E: C5 IE OOOO E 

81 4F 03 8003 
C3 


2E; C5 IE OOOO E 
81 4F 03 0200 
C3 

0286 R 
024D R 
029B R 
OOAO R 
OOC8 R 
OOA1 R 
OOAO R 
OOAO R 
OOD6 R 
OOCF R 
OOAO R 
OOAO R 
OOAO R 


page 

: Command error. 

cmderr: Ids bx , c s : pt r sav e 

or word ptr C bx . st at us ] , 8003 h 

return: ret 

; Ret ur n busy . 

busy: Ids bx , cs : pt r save 

or word ptr I bx . st at us ] , 200h 

r et 


dt b I dw dsK i n i t 

dw mediachk 

dw getbpb 

dw RETURN 

dw read 

dw busy 

dw return 

dw return 

dw write 

dw writ ev 

dw return 

dw return 

dw RETURN 


0 i n i t disks. 

1 check dens. 

2 get BPB, 

3 direct disk reads 

4 read, 

5 not used, 

6 not used, 

7 not used, 

8 write, 

9 wr i t e/ ver , 

10 not used, 

1 1 not used , 

12 direct disk write/format 



00C6 0096 R 


cmder r 


; 13 bad command 
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234 

235 

236 

237 

238 

239 

240 

24 1 

242 

243 

244 

245 

246 

247 

248 

249 

250 

25 1 

252 

253 

254 

255 

256 

257 

258 

259 

260 

26 1 
262 

263 

264 

265 

266 


00C8 C6 06 OOOO R 01 

OOCD EB OC 

OOCP C6 06 OOOO R 03 

OOD4 EB 05 


0006 C6 06 OOOO R OO 
OOOB E8 01EC R 
OODE 72 5C 


page 

; D i sK read/ write entry point . PTRSAV points 
;to the data packet. Perform the function, 

; r et ur n : 

; # sectors actually read, 

status byte (See below) 

; error byte (see below) 

O write protect, 

; 1 unknown unit 

; 2 not ready, 

; 3 command error 

4 data error, 

; 5 bad structure length. 

; 6 seek error . 

; 7 unkown media, 

; 8 sector not found, 

; 9 out of paper , 

: 10 wr i t e f au It , 

; 1 1 read f au It , 

; 12 ot her failure. 


r ead ; 


mov command , f read 

jmp short comn 


mov command , fwr i t ev 

jmp Short comn 


wr i t e : 
comn ; 


mov 
ca 1 1 
jc 


commend . fwr i t e 
set_dr V 
r dwr et 


; set par ms , 
;ret bad unit 


The Microsoft MACRO Assembler 02-20-84 PAGE 1-7 

MSOOS 2.00 Universal Disk driver 


267 page 

268 ; 


269 






Calculate the 

track, given the 1 

ogical sector 

270 






and the numbe 

r of sectors/track. 

Loop over 

27 1 






this 

point t i 

1 all sectors read. 


272 










273 






What 

it does 



274 










275 






1/ 

Find phys. track, sector. 


276 






2/ 

If (scount < sectors left 

on track) { 

277 








read sectors on t 

rack 

278 







} else 

{ 


279 








read (scount) sectors 

280 







} 



28 1 






3/ 

scount 

: scount - sect or s read, 

282 







log. sec : log. sec sec 

tors read. 

283 






4/ 

if scount . gt . 0, goto 1/ 


284 










285 






A 1 1 necessar y 

physical parameter 

s are ca Icu- 

286 






1 at ed 

here, and passed to lower 

level guys 

287 






t hat 

act ua 1 1 y 

do the read or wr i 

t e . 

288 










289 

OOEO 

A1 

0026 

R rdwsec 

mov 

ax.numsec ; 

if all done , 

290 

OOE3 

30 

OOOO 



cmp 

ax , O ; 

r et ur n . 

29 1 

OOE6 

74 

54 





r dwr et 


292 









293 










294 






; of f set i s as 

small as possible ( 

will be 1 ess 

295 






;reading or writing more than 64K 

per BIOS 

296 






; ca 11 . 

Assumes 

less than 64K per 

disk t r ack . 

297 










298 

OOE8 

A1 

0020 

R 


mov 

ax , dmaof f 


299 

OOEB 

0 1 

C8 




r or 

ax, 1 ; 

divide offset 

300 

OOEO 

0 1 

C8 




r or 

ax , 1 ; 

by 1 6 , 1 eave 

301 

OOEF 

0 1 

C8 




r or 

ax , 1 ; 

remainder in 

302 

OOF 1 

0 1 

C8 




r or 

ax. 1 ; 

bits 15- 12 . 

303 

OOF3 

8B 

00 




mov 

dx , ax 


304 

00F5 

25 

OFFF 



and 

ax ,0f f fh 


305 

OOF8 

01 

06 

0022 R 


add 

dmaseg.ax ; 

adjust segment 

306 

OOFC 

8 1 

E2 

FOOO 


and 

dx , Of OOOh 


307 

0 1 OO 

01 

C2 




r o 1 

dx , 1 ; 

put remainder 

308 

0102 

0 1 

C2 




r o 1 

dx. 1 ; 

in LSB ' s . 

309 

0104 

0 1 

C2 




r o 1 

dx. 1 


3 10 

O 106 

0 1 

C2 




r o 1 

dx . 1 


3 1 1 

0108 

89 

1 6 

0020 R 


mov 

dmaof f , dx 

adjust ed off. 
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312 







page 



313 











314 








Figure out how 

many sectors to 

read/write and 

315 








the track to do it on. 


316 











317 

O 1 OC 

A1 

0024 R 



mov 

ax , sect or 

; logical sector 

318 

010F 

88 

OE 

0019 

R 


mov 

cx . spt 

: sect or s/t r ack , 

3 1 9 

01 

1 3 

F6 

F 1 




d i V 

c 1 

; now ALs track. 

320 

oi 

1 5 

FE 

C4 




i nc 

ah 

; AH sect or , 

321 

o 

1 7 

A2 

0002 R 



mov 

track , a 1 

;save track. 

322 

323 

01 

1 A 

88 

26 

0003 

R 


mov 

physec , ah 

;save sector 

324 








Start the read 

or write process. The number of 

325 








sectors to do 

may bring us past the end of the 

326 








cylinder; if so, do (sectors left on track) 

327 








sectors, then 

repeat for each 

track until done 

328 











329 

o 

IE 

8A 

OE 

0003 

R 

dosec ; mov 

c 1 , physec 

; f i nd # sect or s 

330 

0 

22 

B5 

OO 




mov 

ch . O 

; left on 

331 

o 

24 

A1 

001 

9 R 



mov 

ax , spt 

; t h i s track. 

332 

0 

27 

40 





i nc 

ax 

; ( start at 1 , ) 

333 

0 

28 

28 

C 1 




sub 

ax , cx 

: 1 eave in AX , 

334 

o 

2 A 

88 

OE 

0026 

R 


mov 

cx , numsec 

;comp to total 

335 

o 

2E 

38 

C 1 




cmp 

ax , cx 

;if It. total. 

336 

0 

30 

72 

02 





deleft 

; do left track , 

337 

0 

32 

88 

C 1 





mov ax , cx 

;else requested 

338 

o 

34 

A3 

0018 R 


do left; mov 

scount , ax 

; amt . set count 

339 

o 

37 

E8 

015A R 



ca 1 1 

r eadwr i t e 

;do the oper 

340 
34 1 

o 

3A 

73 

A4 




j nc 

rdwsec 

; r pt no error. 

342 








Return to MSDOS. If no error, 

just return: the 

343 








number of sectors read ('count 

' ) is correct. 

344 








If err or , set 

the error code, 

and adjust the 

345 








count to reflect the number actually done. 

346 











347 

0 ' 

I3C 

73 

1 2 



rdwr et ; jnc 

rwr 1 

; i f error. 

346 

0 

1 3E 

2E 

: C4 

1 E 

OOOO E 


1 es 

bx , cs : pt r save 


349 

0 

143 

84 

80 




mov 

ah , 80h 

; er r f lag , 

350 

0 

1 45 

26 

: 09 

47 

03 


or 

es : ( bx . St at us ] , 

ax ; set error , 

35 1 

0 

1 49 

A1 

0026 R 



mov 

ax , numsec 


352 

o 

1 4C 

26 

: 29 

47 

1 2 


sub 

es : [ bx . count ) . a 

X 

353 

0 

1 50 

AO 

0005 R 


r wr 1 : mov 

a 1 , curt r k 

; save cur r ent 

354 

o 

1 53 

86 

1 E 

00 1 1 

R 


mov 

bx , t r kpt r 


355 

0 

157 

88 

07 




mov 

{ bx 1 , a 1 

; t r ack , 

356 

o 

1 59 

C3 





r et 
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357 

358 

359 


02-20-84 


Read or write physical sectors. The physical 


360 






parameters are all set; the sec 

tor count is 

36 1 






equal to or less than the numbe 

r of sectors 

362 






on the track. Returns carry set 

and the MSDOS 

363 






error code in AL if error 


364 








365 






Oo al1 Rainbow sectors one at a 

time for 2 

366 






reasons: a bug in the 280 code 

pr event s 

367 






multiple sectors from working. 

and the 

368 






280 can only access addresses f 

rom 01000 - 

369 






Of f f fh 


370 








37 1 

O 1 5A 




r eadwr i t e : 


372 

OI 5A 

E8 

0 184 R 


call physbuf 

; do buffered. 

373 

OI 5D 

72 

24 



jc rdwrret 

; ex i t if err. 

374 

015F 

AO 

0001 R 


mov a 1 , dskdr V 

;no error - r es< 

375 

0162 

A2 

0028 R 


mov tmr dr V , a 1 


376 

OI 65 

C6 

06 

0029 

R 02 

mov dskt mr . t mrcnt 

;reset counter 

377 








378 






Update' the number of sectors, physical sector. 

379 






and all that stuff. If no more 

to do, return. 

380 






NOTE; This assumes that only one sector is 

38 1 






done per pass . 


382 








383 

01 6A 

A1 

OOOA R 

rwchk; mov ax.secsiz 


384 

0160 

01 

06 

0020 

R 

add draaof f , ax 

; adjust offset 

385 

0171 

FE 

06 

0003 

R 

i nc physec 

; next phys sec 

386 

0175 

FF 

06 

0024 

R 

i nc sector 

; next log sec 

387 

0179 

FF 

OE 

0026 

R 

dec numsec 

; t ot a 1 t o do , 

388 

0170 

FF 

OE 

OO 1 B 

R 

dec scount 

; new count , 

389 

0181 

75 

07 



j n 2 r eadwr i t e 


390 

0183 

C3 



r dwr r et : r et 

; done this t r k 


t i mer /dr i ve 
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391 

392 

393 

394 

395 

396 

397 

398 

399 

400 

401 

402 

403 

404 

405 

406 

407 

408 

409 
4 10 
4 1 1 
4 1 2 
413 
4 1 4 
415 
4 1 6 
4 1 7 
4 1 8 

419 

420 
42 1 

422 

423 

424 

425 

426 


The 

MSDOS 


427 

428 

429 

430 

43 1 

432 

433 

434 

435 

436 

437 

438 

439 

440 

44 1 

442 

443 

444 

445 

446 

447 

448 







; Read or write data to our local 

buffer . Copy 






;the data in 

or out of the buffer as necessary. 






;Return carry set and AL error code if bad. 

0184 





physbuf : 



0184 

C7 

06 OOOC 

R 

OOOO E 

mov 

dskof f . of f set buffer 

01 8A 

8C 

IE OOOE 

R 


mov 

dskseg . ds 

set local buf 

01 8E 

C6 

06 0004 

R 

01 

mov 

physcnt , 1 

one sect or , 

0193 

80 

3E OOOO 

R 

03 

cmp 

command, fwr itev 

write verify 

0198 

74 

07 



je 

wrt buf 


01 9A 

80 

3E OOOO 

R 

OO 

cmp 

command , f wr i t e 


01 9F 

75 

1 D 



jne 

dor d 

if write. 

01 A1 





wrt buf : 



01 A1 

8B 

OE OOOA 

R 


mov 

cx . secs i X 


01 A5 

8B 

36 0020 

R 


mov 

s i . dmaof f 

from DMA 

01 A9 

BF 

OOOO E 



mov 

di, offset buffer 

;to buffer 

01 AC 

8C 

DA 



mov 

dx . ds 

save DS , 

01 AE 

8E 

C2 



mov 

es , dx 

ES s buffer. 

01B0 

2E ; 

8E IE 

0022 R 

mov 

ds . cs : dmaseg 

DS = dest . , 

01 B5 

FC 




c Id 



01 B6 

F3/ 

A4 



rep 

movsb 

copy to buf 

01B8 

8E 

DA 



mov 

ds , dx 

rest ore DS , 

01BA 

E8 

01D7 R 



ca 1 1 

dophys 

write to disk. 

01 BD 

C3 




ret 


return status. 

01BE 

E8 

01 D7 R 



dor d : call 

dophys ; 

r ead , do i t , 

01C1 

72 

1 3 



jc 

pret ; 

stop if error. 

01C3 

8B 

OE OOOA 

R 


mov 

cx , secs i 2 


01 C7 

BE 

OOOO E 



mov 

si .off set buffer 

;copy data 

01 CA 

8B 

3E 0020 

R 


mov 

d i , dmaof f 


01CE 

2E ; 

8E 06 

0022 R 

mov 

es.cs: dmaseg 

t o seg ; o f f , 

01 D3 

FC 




c 1 d 



01 D4 

F3/ 

A4 



rep 

movsb ; 

copy from buf 

01 D6 

C3 




pret : ret 


r et ur n st at us . 
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0 1 07 
01D7 
O10A 
01DE 

01 E3 
01E5 
01E8 
01EB 


BB OOOO R 

FF 16 001E R 

C6 06 0005 R FF 

72 06 

AO 0002 R 

A2 0005 R 

C3 


page 

;Do the physical read or 
;the disk command block. 

; f ound in the 'dsKtbl'. 
;return carry set and th 
;AL if error. 

;After the read or write, 
;track for this disk. If 
;track to -1, to indicate 
;wi11 recal the disk befor 
.current track is -1.) 

dophys : 

mov bx , of f set 

ca 1 1 word pt r 

mov curt r k . - 1 

jc dpi 

mov a 1 , t r ack 

mov cur t r k , a 1 

dpi; ret 


write as specified by 
The driver to use was 
The physical drivers 
e MSDOS error code in 


update the current 
error, set the current 
an error. (The driver 
e seeking if the 


cmdstr ; setup command 
ca 1 1 addr ; do i t , 

; assume bad, 

; i f good , set 
;current track. 
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449 





paae 



480 









481 






Given the drive number, pull 

out the physical 

482 






parameters necessary to read 

and write. 

483 






The parameters 

are : 


484 






RP8 pointer. 


485 






fixed/removable disk. 


486 






read/write driver addr 

ess , 

457 






Physical drive number. 


458 






Dens i t y 

flag, 


458 






Sect or 

size. 


460 






Current 

track. 


46 1 






Sect or s 

per track. 


462 






Dens i t y 

check track. 


463 






NEC765 

parameter s . 


464 









465 

01EC 




set drv ; 



466 

01EC 

8A 

1 E OO 

10 

R 

mov 

b1 . dr i ver 


467 

01FO 

3A 

IE OOOO 

E 

cmp 

b1,byte ptr dsktbl; legal unit? 

468 

01F4 

72 

04 



jb 

sdr V 1 


468 

01F6 

F9 




St c 

; no , 

470 

01F7 

60 

oi 




mov a 1 , 1 


47 1 

01F9 

C3 





r et 


472 

0 1 FA 

87 

OO 


Sdr V 1 : mov 

bh . 0 

; 1 St t i me , get 

473 

0 1 FC 

D 1 

E3 



sh 1 

bx , 1 

; dsk dat a ptr, 

474 

01FE 

86 

9F O001 

E 

mov 

bx . dsktbl [ bx4 - 1 

] ;8Xs disk ptr 

475 

0202 

86 

77 06 



mov 

s i , t bx + 6 1 

; S I : t ype pt r 

476 

0205 

89 

36 0015 

R 

mov 

t yppt r , s i 

; save type ptr 

477 

0209 

8A 

04 



mov 

a 1 , t s i 1 

; get curr form 

478 

0208 

25 

0007 



and 

ax , 7 

: t hr ee choices 

479 

020E 

03 

D8 



add 

bx , ax 

; add word offs 

480 

02 10 

03 

D8 



add 

bx , ax 

; get dsk dat a , 

481 

02 1 2 

86 

37 



mov 

s i . ( bx ] 

482 









483 

02 1 4 

FC 




c Id 



484 

02 1 5 

AD 




1 odsw 


; 6PB pointer. 

485 

02 1 6 

A3 

0013 

R 


mov 

bpbpt r , ax 


486 

02 1 9 

AD 




1 odsw 


: r emovab 1 e f la 

487 

02 1 A 

A2 

OO 1 7 

R 


mov 

chkbyt e , a 1 

488 

02 1 D 

AD 




1 odsw 


; dr i ver addr es 

489 

02 1 E 

A3 

00 1 E 

R 


mov 

call addr , ax 


490 

022 1 

AD 




1 odsw 


; cur , t r k ptr, 

49 1 

0222 

A3 

001 1 

R 


mov 

t r kpt r , ax 

492 

0225 

86 

D8 



mov 

bx . ax 

;current track 

493 

0227 

8A 

07 



mov 

a 1 , C bx ] 


494 

0229 

A2 

0005 

R 


mov 

cur t r k , a 1 


495 









496 

022C 

AD 




1 odsw 


; sector size, 

497 

022D 

A3 

OOOA 

R 


mov 

secs i z , ax 


498 

0230 

AO 




1 odsw 


; sect or s/t rack 

499 

023 1 

A3 

00 19 

R 


mov 

spt , ax 


500 

0234 

AO 




1 odsw 


; dens i t y byt e , 

501 

0235 

A2 

0006 

R 


mov 

dens i t y . a 1 

502 

0238 

AO 




1 odsw 


;physica1 drivi 

503 

0239 

A2 

000 1 

R 


mov 

dskdr V . a 1 
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504 

023C 

AD 



1 odsw 



505 

023D 

A2 

00 18 

R 

mov 

dent r k , a 1 

; dens . c hk . t r k 

506 

0240 

AD 



1 odsw 



507 

024 1 

A2 

0007 

R 

mov 

gap 1 en , a 1 

; gap length , 

508 

0244 

AD 



1 odsw 


509 

0245 

A2 

0008 

R 

mov 

enn , a 1 

; sect or size. 

5 10 

0248 

AD 



1 odsw 



5 1 1 

0249 

A2 

0009 

R 

mov 

dt 1 , a 1 

; dat a length. 

5 1 2 

024C 

C3 



r at 



cur r XX ) 
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513 






page 




514 










515 






;Disk change 

detect routine. 


5 1 8 






; a 1 ways 

returns dont know 


517 






; Ret urns 1 i f 

fixed disk (didn' 

t change ) . 

518 






; 



519 

024D 





med i achk : 



520 

024D 

E8 

01EC R 



cal 1 

set__dr V 

; se 1 ect drive , 

521 

0250 

BO 

oi 




mov 

a 1 ,T 

; unknown unit. 

522 

0252 

B4 

FF 




mov 

ah , - 1 

; unknown change 

523 

0254 

72 

1 6 




jc 

samdsk 

; return error , 

524 










525 

0256 

33 

CO 




xor 

ax , ax 

;assume don't know 

526 

0258 

8A 

IE 

0001 

R 


mov 

b1 , dskdr V 

.■current disk 

527 

025C 

3A 

IE 

0028 

R 


cmp 

b1 , tmrdrv 

;match last one used? 

528 

0280 

75 

09 




jni 

maybec 


529 

0262 

80 

3E 

0029 

R 00 


cmp 

dskt mr , 0 

; t i mer exp i r ed? 

530 

0267 

74 

02 




jo 

maybec 

; jump if too lat e 

53 1 

0269 

B4 

01 




mov 

ah , 1 

;f1ag not changed 

532 

026B 





maybec : 




533 

026B 

F8 





c 1c 


; no error. 

5 34 

026C 





samdsk : 




535 

026C 

8B 

36 

O01 1 

R 


mov 

s i , t rkpt r 


536 

0270 

8A 

OE 

0005 

R 


mov 

c 1 , curtrk 


537 

0274 

88 

OC 




mov 

I s i ] , c 1 ; phys 

trackscur .track 

538 









539 

0276 

2E 

C5 1 E 

OOOO E 


Ids 

bx , cs : pt r save 

; sot for ret. 

540 

027B 

88 

67 

OE 



mov 

[ bx . med i a+ 1 ] , ah 

; set r et code , 

54 1 

027E 

73 

05 




jnc 

dc r 1 

; i f error. 

542 









543 

0280 

B4 

80 




mov 

ah . 80h 

; set err bit. 

544 

0282 

09 

47 

03 



or 

I bx . St at us ] , ax 

; r et ur n error. 

545 

0285 





dcr 1 : 




546 

0285 

C3 





r et 
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547 

548 

549 

550 

55 1 

552 

553 

554 

555 

556 

557 

558 

559 

560 

56 1 

562 

563 

564 

565 

566 


; D i sK i n i t i a 1 i 2 at i on . Return a pointer to the 
; i n i t i a 1 i 2 at i on table, and the number of units. 


0286 
0286 
0289 
028B 
028C 
029 1 
0294 
0297 
029A 


BE OOOO E 
8A 04 
4 6 

2E; C5 IE OOOO E 

88 47 OD 

89 77 12 

8C 4F 14 
C3 


mov 
mov 
i nc 
Ids 
mov 
mov 
mov 
r et 


si. offset i n i 1 1 b 1 ; t ab 1 e pt r , 


9 1 . [ s i 1 
S i 

bx . cs : pt r save 
[ bx . med i a ] , a 1 
[ bx . count ] , s i 
[ bx . st ar t ] , c s 


; P disks, 

; pt r to pt r s , 


Build BPB pointer. All it does is 'select' 
the disk internally, and return a pointer to 
the BPB table. 


567 

029B 





get bpb : 





568 

029B 

E8 

02B 1 R 



cal 1 

chkmed 

check 

media type for drive 

569 

029E 

E8 

01EC R 



call 

set_dr V 



570 

02A 1 

A 1 

00 13 R 



mov 

ax , bpbpt r 



57 1 

02A4 

C5 

1 E 

OOOO 

E 


Ids 

bx , pt r sav e 



572 

02A8 

89 

47 

1 2 



mov 

[ bx . count ] , ax 

r et ur n 

DWORD 

573 

02AB 

8C 

C8 




mov 

ax . cs 

ptr to 

table. 

574 

02AD 

89 

47 

1 4 



mov 

[ bx . st ar t ] , ax 



575 

02B0 

C3 





r et 




576 











577 

s OOOO 





i of un 

equ 

0 

i oct 1 

packet function offset 

578 

s 000 1 





i odr V 

equ 

1 

i oct 1 

packet drive offset 

579 

s 0002 





i osec 

equ 

2 

i oct 1 

packet sector offset 

580 

: 0004 





i ot r K 

equ 

4 

i oct 1 

track offset 

581 

: 0006 





i ocnt 

equ 

6 

i oct 1 

sector count 

582 

: 0008 





i oof f 

equ 

8 

i oct 1 

buffer offset 

583 

s OOOA 




i oseg 

equ 

Oah 

i oct 1 

buffer segment 

584 











585 

02B 1 

AO 

0010 R 


chkmed : 

mov 

a 1 , dr i ver 

get current drive to check 

586 

02B4 

3A 

06 

OOOO 

E 


cmp 

a 1 , byt e ptr dsktbl ; see 

if it is a valid drive 

587 

02B8 

72 

06 




jb 

ckmda 1 



588 

02BA 

BO 

OI 




mov 

a 1 . 1 



589 

02BC 

F9 





St c 




590 

02BD 

EB 

45 

90 



jmp 

ba i 1 out 



59 1 

02C0 





cKmda 1 : 





592 

02C0 

80 

3E 

0339 

R 01 


cmp 

byte ptr mc^flg. 


; check media check flag 

593 

02C5 

75 

04 




jnt 

normal ~ 


: do check 

594 

02C7 

33 

CO 




xor 

ax , ax 


; set to RAINBOW media 

595 

02C9 

EB 

25 




jmp 

short okmdia 


; and skip media check 

596 

02CB 





norma 1 : 





597 

02CB 

BB 

033A R 



mov 

bx . of f set i opkt 



598 

02CE 

8C 

5F 

OA 



mov 

i oseg [ bx ] , ds 


;io xfer buffer segment 

599 

02D 1 

C7 

47 

08 OOOO E 


mov 

word ptr i oof f [ bx } , of f set buffer ;io xfer buffer 

600 

0206 

88 

47 

OI 



mov 

i odr V ( bx ] , a 1 


; dr i ve t o check 

601 

0209 

C6 

07 

04 



mov 

byte ptr iofun[bx],04 

;check media function 


codes 
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602 


603 

02DC 

CD 

65 


i nt 

dskdret 


;direct disk driver interrupt 

604 









605 

02DE 

BO 

oi 


raov 

al . 01 


; i n case of error 

606 

O2E0 

72 

22 


jc 

ba i lout 


;b1ast out of here 

607 

02E2 

BB 

OOOO E 

mov 

bx , of f set 

buffer 

;raedia type is in first byte of 

606 

02E5 

33 

CO 


xor 

ax , ax 


clear field for weird 

609 

02E7 

6A 

07 


raov 

a 1 , [ bx I 


get media type 

610 

02E9 

3C 

0 1 


emp 

a 1 . O 1 


if this is a rainbow or i bro6 , Ok 

61 1 

02EB 

76 

03 


jbe 

okmd i a 


else fin out what it really .is 

612 

02ED 

E8 

0305 R 

ca 1 1 

sof t chk 


do a soft media check (read disk 10) 

613 

02P0 




okrad i a ; 




614 

02P0 

33 

06 


xor bx 

bx 


clear pointer 

615 

02F2 

6A 

IE 

0010 R 

mov 

b 1 , dr i ver 


; get current disk again 

6 1 6 

02F6 

01 

E3 


sh 1 

bx , 1 


.make worb index 

6 1 7 

02F8 

8B 

9F 

0001 E 

mov 

bx , dskt b 1 ( bx*f 1 ] 

; and get media type table for drive 

6 1 8 

02FC 

6B 

77 

06 

mov 

s i , [ bx<^6 ] 


: get pointer to media type holder 

6 1 9 

02FF 

68 

04 


mov 

[ s i j , a 1 


;and save media type 

620 

0301 

32 

CO 


xor 

a 1 , a 1 


;c1ear status 

62 1 

0303 

F8 



c 1 c 



:accross the board 

622 

0304 




ba i 1 out : 




623 

0304 

C3 



rot 




624 









625 

0305 




sof t chk ; 

; 

coft media check to see if real 9 sector 

626 

0305 

BB 

033A R 

mov 

bx . offset 

i opkt 

read the disk id byte to check illogica 

627 

0308 

AO 

001 

0 R 

mov 

a 1 , dr i ver 


get dr i ve type 

628 

030B 

88 

47 

OI 

mov 

i odr V [ bx ] 

. a 1 

drive to r ead 

829 

030E 

C6 

47 

02 02 

mov 

byte ptr 

iosec(bxl,2 ,‘type byte is on sector 2 

630 

03 1 2 

C7 

47 

04 OOOO 

mov 

word ptr 

iotrk(bx],0 ; on track 0 

63 1 

03 17 

C7 

47 

06 OO01 

mov 

word ptr 

iocnt[bx],1 ;on1y reat 1 sector, of course 

632 

03 1 C 

C7 

47 

08 OOOO E 

mov 

word ptr 

i oof f ( bx 1 , of f set buf f er ; def au 1 t sector buffer 

633 

032 1 

6C 

5F 

OA 

mov 

i oseg [ bx ] 

. ds 

default data segment 

634 

0324 

C6 

07 

OO 

raov 

byte ptr 

iofun[bx],0 ;read data command 

635 









636 

0327 

CD 

65 


i nt 

dskdret 


direct disk interrupt 

637 

0329 

72 

OD 


jc 

ex i t o 


exito; greek for throwing garbage out 

638 









639 

0326 

BB 

OOOO E 

mov 

bx , offset 

buffer 

; get dat a byt e 

640 

032E 

8A 

07 


mov 

a 1 , I bx ] 


get id byte 

64 1 

0330 

3C 

FE 


emp 

1 1 , o f e h 


is it an i bm8 

642 

0332 

BO 

OI 


mov 

a 1 , O 1 


if so, say so 

643 

0334 

74 

02 


j* 

ex i t o 


and leave 

644 

0336 

BO 

02 


mov 

a 1 , 02 


else it is an i bm9 

645 

0338 

C3 



ox i t o : ret 



return with media type in al 
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646 

647 

648 033S OO 
648 

6S0 
65 1 

652 033A 10 

653 

654 

655 

656 

657 

658 


PAGE 


MC_FLG DB O 


media check flag, O s check default 
1 = don't check assume RAINBOW disk 


iopkt; db lOh dup (?) 


; space for packet 


buffer 


034A 


code 


ends 

end 
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Structures end records: 


N 


in e 


Width # fields 

Shift Width Mask Initial 


lODATA 0016 0009 

CMDLEN OOOO 

UNIT O001 

CMD 0002 

STATUS 0003 

MEDIA OOOD 

TRANS OOOE 

COUNT 0012 

START 0014 


Segments and groups: 


N a 


m e 


align combine class 


CGROUP 

CODE 


GROUP 

034A BYTE PUBLIC 'CODE' 


Symbo 1 s : 


N a 


e 


Type Value Attr 


AUXDP. . 
AUXP . . 

AUX_PRN . 
BAILOUT . 
BPBPTR . 
BUFFER . 
BUSY . . 

CALLADOR 
CHKBYTE . 
CHKMED . 
CKM0A1 
CLK INT. 
CMDERR . 
CMDOK. . 
CMDSTR . 
COMDMA . 
COMMAND . 
COMN . . 

CURTRK . 
0CR1 . . 

DENSITY . 
DENTRK . 
DISPATCH 
OMAOFF . 
DMASEG . 
DOLEFT . 
DOPHYS . 
DORD . . 

DOSEC. . 
DPI. . . 


Number 0040 
Number 0042 
Number 0044 
L NEAR 0304 
L WORD 00 13 
L NEAR OOOO 
L NEAR OOA1 
L WORD 001E 
L BYTE 0017 
L NEAR 02B1 
L NEAR 02C0 
Number 002C 
L NEAR 0096 
L NEAR 0077 
L NEAR OOOO 
Number 0043 
L BYTE OOOO 
L NEAR 0006 
L BYTE 0005 
L NEAR 0285 
L BYTE 0006 
L BYTE 0018 
F PROC 002A 
L WORD 0020 
L WORD 0022 
L NEAR 0134 
L NEAR 01D7 
L NEAR 01BE 
L NEAR O 1 1 E 
L NEAR 01EB 


CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 

CODE 


Externa 1 


Global 


Length s006C 
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DRIVER . 
DSK. . . 

DSKDRCT . 
DSKDRV . 
OSKINI T . 
OSKIO. . 
DSKOFF . 
DSKSEG . 
DSKTBL . 
DSKTMR . 
DTBL . . 

DTL. . . 

ENN. . . 

ERRMSK . 
EXCOM. . 
EXITO. . 
FDENS. . 
FREAD. . 
FWRITE . 
FWRITEV . 
GAPLEN . 
GETBPB . 
INITTBL . 
lOCNT. . 
lODRV. . 
lOFUN. . 
lOOFF. . 
lOPKT. . 
lOSEC. . 
lOSEG. . 
lOTRK. . 
KDP. . . 

KSP. . . 

MAYBEC . 
MC__FLG . 
MEDIACHK 
NOINT. . 
NORMAL . 
NUMSEC . 
OKMOIA . 
PHYSBUF . 
PHYSCNT . 
PHYSEC . 
PRET . . 

PRNDP. . 
PRNP . . 

PROFILE . 
PTRSAVE . 
RDWRET . 
RDWRRET . 
RDWSEC . 
READ . . 

READWRITE 
RETURN . 
ROM. . . 
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L BYTE 

OO 1 o 

CODE 


L NEAR 

002A 

CODE 

G 1 oba 1 

Number 

0065 



L BYTE 

OOO 1 

CODE 


L NEAR 

0286 

CODE 


Number 

0065 



L WORD 

OOOC 

CODE 


L WORD 

OOOE 

CODE 


V WORD 

OOOO 


Externa 1 

L BYTE 

0029 

CODE 

Global 

L WORD 

OOAC 

CODE 


L BYTE 

0009 

CODE 


L BYTE 

0008 

CDDE 


L BYTE 

OO 1 D 

CODE 


Number 

0045 



L NEAR 

0338 

CODE 


Number 

0002 



Number 

000 1 



Number 

OOOO 



Number 

0003 



L BYTE 

0007 

CODE 


L NEAR 

029B 

CODE 


V WORD 

OOOO 


Exter na 1 

Number 

0006 



Number 

OOO 1 



Number 

OOOO 



Number 

0008 



L NEAR 

033A 

CODE 


Number 

0002 



Number 

OOOA 



Number 

0004 



Number 

OO 1 O 



Number 

00 1 1 



L NEAR 

026B 

CODE 


L BYTE 

0339 

CODE 

Global 

L NEAR 

024D 

CODE 


L NEAR 

0043 

CODE 


L NEAR 

02CB 

CODE 


L WORD 

0026 

CODE 


L NEAR 

02F0 

CODE 


L NEAR 

0184 

CODE 


L BYTE 

0004 

CODE 


L BYTE 

0003 

CODE 


L NEAR 

0106 

CODE 


Number 

004 1 



Number 

0043 



Number 

0064 



V DWORD 

OOOO 


Ext er na 1 

L NEAR 

01 3C 

CODE 


L NEAR 

0183 

CODE 


L NEAR 

OOEO 

CODE 


L NEAR 

OOC8 

CODE 


L NEAR 

01 5A 

CODE 


L NEAR 

OOAO 

CODE 


Number 

0018 
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RWCHK L NEAR 018A CODE 

RWR1 L NEAR 0160 CODE 

SAMDSK L NEAR 026C CODE 

SCOUNT L WORD 0016 CODE 

SDRV1 L NEAR 01PA CODE 

SECSIZ L WORD OOOA CODE 

SECTOR L WORD 0024 CODE 

SET DRV L NEAR 01EC CODE 

SOfTcHK L NEAR 0305 CODE 

SPARE41 Number 0041 

SPARE42 Number 0042 

SPT L WORD 0019 CODE 

TMRCNT Number 0002 

THRDRV L BYTE 0028 CODE 

TRACK L BYTE 0002 CODE 

TRKPTR L WORD O0 1 1 CODE 

TYPPTR L WORD 00 15 CODE 

UART Number 0046 

VERT Number 0040 

WPRSNT Number OOO 1 

WRITE L NEAR OOD6 CODE 

WRITEV L NEAR OOCF CODE 

WRTBUF L NEAR 01A1 CODE 

XCPRSNT Number 0002 

280 Number 0047 

Warning Severe 
Err ors Errors 


O O 
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Symbol Cross Reference (# is definition) Cref-1 

AUXDP 57# 

AUXP 59# 

AUX_PRN 47# 

BAILOUT 590 606 622# 

BPBPTR 135# 485 570 

BUFFER 67# 398 408 421 599 607 632 639 

BUSY 215# 224 

CALLADDR 142# 443 489 

CGROUP 11 70 70 

CHKBYTE 137# 487 

CHKMED 568 585# 

CKM0A1 587 59 1# 

CLK_INT 33# 

CMD 89# 169 183 

CMDERR 209# 233 

CMDLEN 87# 

CMDOK 185 187# 

CMDSTR 14 115# 442 

CODE 11 69# 69 657 

COMDMA 46# 

COMMAND 116# 258 261 264 401 403 

COMN 259 262 265# 

COUNT 97# 175 352 558 572 

CURTRK 121# 353 444 447 494 536 

0CR1 541 545# 

DENSITY 122# 501 

DENTRK 138# 505 

DISPATCH 155# 204 

DMAOFF 143# 180 298 31 1 384 407 422 

DMASEG 144# 182 305 41 1 423 

DOLEFT 336 338# 

DOPHYS 415 418 441# 

DORD 404 418# 

DOSEC 329# 

DPI 445 448# 

DRIVER 133# 174 466 585 615 627 

OSK 13 154# 

DSKDRCT 106# 603 636 

DSKDRV 117# 374 503 526 

DSKINIT 219 552# 

DSKIO 34# 

DSKOFF 127# 398 

DSKSEG 128# 399 

OSKTBL 17# 467 474 586 617 

DSKTMR 14 149# 376 529 

DTBL 1 89 2 19# 

DTL 1 25# 5 1 1 

ENN 124# 509 

ERRMSK 141# 

EXCOM 48# 

EXITO 637 643 645# 

FDENS 104# 
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Symbol Cross 

Reference 



(# is 

def i ni t i 

i on ) 

Crof -2 



FREAD. . . . 




103# 

258 






FWRITE . . . 




102# 

264 

403 





FWRITEV. . . 




10S# 

26 1 

401 





GAPLEN . . . 




123# 

507 



P' 



GETBPB . . . 




22 1 

567# 






INITTBL. . . 




17# 

553 






lOCNT. . . . 




S8 1# 

63 1 






lODATA . . . 




86# 

99 






lOORV. . . . 




S78# 

600 

628 





lOFUN. . . . 




577# 

601 

634 





lOOFF. . . . 




582# 

599 

632 





lOPKT. . , . 




597 

626 

652# 





lOSEC. . . . 




579# 

629 






lOSEG. . . . 




583# 

598 

633 





lOTRK. . . . 




580# 

630 






KDP 




55# 







KSP 




56# 







MAYBEC . . . 




528 

530 

532# 





MC FLG . . . 




1 3 

592 

648# 





MEDIA. . . . 




95# 

540 

557 





MEDIACHK . . 




220 

5 19# 






NOINT. . . . 




1 70 

172# 






NORMAL . . . 




593 

596# 






NUMSEC . . . 




146# 

176 

289 

334 

351 387 



OKMDIA . . . 




595 

61 1 

6 1 3# 





PHYSBUF. . . 




372 

397# 






PHYSCNT. . . 




1 20# 

400 






PHYSEC . . . 




1 1 9# 

322 

329 

385 




PRET .... 




419 

426# 






PRNDP. . . . 




58# 







PRNP .... 




60# 







PROFILE. . . 




32# 







PTRSAVE. . . 




1 6# 

1 68 

1 9 1 

209 

215 348 

539 

556 571 

RDWRET . . . 




266 

29 1 

347# 





RDWRRET. . . 




373 

390# 






ROWS EC . . . 




289# 

340 






READ .... 




223 

258# 






READWRITE. . 




339 

37 1# 

389 





RETURN . . . 




2 11# 

222 

225 

226 

229 230 

23 1 


ROM 




5 1# 







RWCHK. . . . 




383# 







RWR 1 . . . . 




‘ 347 

353# 






SAMDSK . . . 




523 

534# 






SCOUNT . . . 




1 40# 

338 

388 





SDRV 1 . . . . 




468 

472# 






SECSIZ . . . 




126# 

383 

406 

420 

497 



SECTOR . . . 




145# 

178 

3 1 7 

366 




SET DRV . . . 




265 

465# 

520 

569 
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Symbol Cross 

Refer ence 



(# is ' 

def i ni t i 

ion) 

Cref -3 



SOFTCHK. . . 




6 1 2 

625# 






SPARE4 1 . . . 




44# 







SPARE42. . . 




45# 







SPT 




139# 

3 1 8 

33 1 

499 




START. . . . 




98# 

1 77 

559 

574 




STATUS . . . 




90# 

172 

192 

2 1 0 

216 350 

544 


TMRCNT . . . 




107# 

149 

376 





TMRDRV . . . 




148# 

375 

527 





TRACK. . . . 




1 1 8# 

32 1 

446 





TRANS. . . . 




96# 

1 79 

1 8 1 





TRKPTR . . . 




134# 

354 

49 1 

535 




TYPPTR . . . 




136# 

476 






UART .... 




49# 







UNIT .... 




88# 

173 






VERT .... 




43# 







WPRSNT . . . 




64# 







WRITE. . . . 




227 

264# 






WRITEV . . . 




228 

26 1# 






WRTBUF . . . 




402 

405# 






XCPRSNT . . . 




65# 







280 




50# 






I 
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TITLE Hard Disk driver 
NAME HOISK ^ 


5 

6 
7 
6 
S 

10 
1 1 
1 2 
1 3 

14 0000 

1 5 
1 6 
1 7 
1 8 

1 9 
20 

2 1 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 


The Microsoft MACRO Assembler 
Hard Disk driver 

C ommon 


COMPANY CONFIDENTIAL 

Copyright (C) 1983 Digital Equipment Corporation 

; All rights reserved. 

; Hard Disk Driver for Version 2.05 of MS-DOS. 

09/22/83 

CGROUP GROUP CODE 

CODE SEGMENT BYTE PUBLIC 'CODE' 

ASSUME CS;CGROUP. DSrCGROUP, ES : CGROUP , SS ; CGROUP 


EXTRN HREAO:NEAR. HWRITEtNEAR, HWRITEV:NEAR 

EXTRN HPORMAT : NEAR , HINIT:NEAR, HMCHK:NEAR 

EXTRN HVDISK:NEAR. INTHDL:NEAR. DSK INIT:NEAR 

EXTRN XLT_F:BYTE. PTRS AVE : DWORD . NDRVrBYTE 

EXTRN HIOCTL-.NEAR. UP_BAT;NEAR 

EXTRN TEMP__TRK :WORD . T EMP_S E C : B Y T E 


PUBLIC INI_TAB. RDXLT 
PUBLIC CETFTN, GETFTNO. GETPEA 
PUBLIC PARTITION. MNPARTS , PART_S I ZE 
PUBLIC HOSKO, DSK_INT 

. LIST 


SUBTTL 


Common Drive parameter 


block 


def t n i t i ons 
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Drive parameter block definitions 


32 
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DBP 

STRUC 


34 






35 



, . - 

Start 

of Drive Parameter Block. 

36 






37 

oooo 

?7?7 

SECSZ 

OW 

7 ;Sector size in bytes. 

38 

0002 

7 7 

ALLOC 

OB 

7 ;Number of sectors per alloc, block 

39 

0003 

7777 

RESSEC 

OW 

7 ;Reserved sectors. 

40 

0005 

77 

FATS 

OB 

7 ; Number of FAT's. 

4 1 

0006 

77 7 7 

MAXDIR 

OW 

7 ;Number of root directory entries. 

42 

0008 

7777 

SECTORS 

DW 

7 , -Number of sectors per diskette. 

43 

OOOA 

77 

MEDI AI 0 

DB 

7 ; Med i a byt e ID. 

44 

OOOB 

7777 

FATSEC 

OW 

7 ;Number of FAT Sectors 

45 






46 



;------ 

End of 

Drive Parameter Block. (Extensions follow) 

47 






48 

OOOD 

7777 

SECTRK 

DW 

7 .’Number of Sectors per track. 

49 

OOOF 

7777 

HEADS 

OW 

? ; Number of heads per cylinder. 

50 

001 1 

7777 

HIDDEN 

OW 

7 ; Number of hidden sectors. 

5 1 






52 

0013 


DBP 

ENDS 


53 






54 

OOOO 

0200 

HDSKO 

DBP 

<512. 4. 2*16. 2, 256,0, OF 8H. 0.16.4.0 

55 

0002 

04 




56 

0003 

0020 




57 

0005 

02 




58 

0006 

0100 




59 

0008 

OOOO 




60 

OOOA 

F8 




6 1 

OOOB 

OOOO 




62 

OOOD 

0O1O 




63 

OOOF 

0004 




64 

00 1 1 

OOOO 




65 






66 

0013 

0200 

H0SK1 

DBP 

<512. 4. 2*16, 2, 256,0, OFBH, 0,16, 4.0 

67 

00 15 

04 




68 

00 16 

0020 




69 

00 18 

02 




70 

0019 

01OO 




71 

00 IB 

OOOO 




72 

OO10 

F8 




73 

001E 

OOOO 




74 

0020 

0010 




75 

0022 

0004 




76 

0024 

OOOO 




77 






78 

0026 

0200 

HDSK2 

DBP 

<512.4,2»16.2,256,0,0F8H.0.16,4,O 

79 

0028 

04 




80 

0029 

0020 




81 

002B 

02 




82 

002C 

0100 




83 

002E 

OOOO 




84 

0030 

F8 




85 

0031 

OOOO 




86 

0033 

0010 





( dpb) 
( dpb) 
( dpb) 
( dpb ) 
( dpb) 
( dpb) 
( dpb) 
( dpb ) 
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87 

0035 

0004 

88 

0037 

OOOO 

89 



90 

0039 

0200 

9 1 

003B 

04 

92 

003C 

0020 

93 

003E 

02 

94 

003F 

0100 

95 

004 1 

OOOO 

96 

0043 

F8 

97 

0044 

OOOO 

98 

0046 

0010 

99 

0048 

0004 

100 

004A 

OOOO 

101 



102 



103 

004C 

OOOO 

1 04 

004E 

0013 

105 

0050 

0026 

106 

0052 

0039 


107 

108 


I t 

02-20-84 PAGE 1-3 

Common Drive parameter block definitions 


H0SK3 DBP <5 1 2 . 4 . 2* 1 6 , 2 , 2S6 . O, OF8H , O, 1 6 , 4 , 0> 


INI TAB DW 
■” DW 

DW 
DW 


OFFSET HOSKO 
OFFSET HDSK1 
OFFSET HDSK2 
OFFSET H0SK3 


SUBTTL Strategy and Software Interrupt routines. 


???? 

08 [ 
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109 
1 1 O 
1 1 1 
1 1 2 

1 1 3 OOOO 

1 1 4 0001 

1 1 5 0002 

1 1 6 0003 

1 1 7 0005 
1 1 8 

1 1 9 
1 20 

121 OOOO 

122 OOOE 

123 0012 

124 0014 

125 0016 

126 
1 27 
1 28 
1 29 
1 30 
1 3 1 
1 32 
1 33 
1 34 
1 35 

136 

137 
1 38 
1 39 

140 0054 

1 4 1 


02-20-84 PAGE 1-4 

ategy and Software Interrupt routines. 
PAGE 

;Define offsets for io data packet 


777777 

777? 


lODAT STRUC 
CMDLEN DB 
UNIT DB 

CMD DB 

STATUS DW 
DB 


MEDIA DB 
TRANS DD 
CDUNT DW 
START DW 
IDDAT ENDS 


8 DUP (7) 


»**«»»» 




DSK_INT - Disk driver 


When perform disk function command 
AL : Unit code . 

AH : Media descriptor. 

CX * Contains byte/sector count. 

DX s Starting Logical sector. 

ES:OI s Transfer address 


LENGTH OF THIS CDMMAND 
SUB UNIT SPECIFIER 
CDMMAND CDDE 
STATUS 


MEDIA DESCRIPTDR 
TRANSFER ADDRESS 

CDUNT DF BLOCKS OR CHARACTERS 
FIRST BLOCK TO TRANSFER 


nterrupt routine 

register contains: 




dispatch proc far 




142 

0054 





OSK_INT 


143 

0054 

50 





PUSH 

144 

0055 

53 





PUSH 

1 45 

0056 

5 1 





PUSH 

146 

0057 

52 





PUSH 

1 47 

0058 

56 





PUSH 

148 

0059 

57 





PUSH 

149 

005A 

55 





PUSH 

150 

0056 

IE 





PUSH 

1 5 1 

005C 

06 





PUSH 

152 

005D 

2E : 

: CS 

IE 

OOOO E 


LDS 

153 

0062 

80 

7F 

02 

OO 


CMP 

154 

0066 

74 

01 




JE 

1 55 

0068 

FB 





STI 

156 

0069 

C7 

47 

03 

OOOO 

NOINT : 

MOV 

157 








158 

006E 

8A 

47 

01 



MOV 

1 59 

007 1 

8A 

87 

OD 



MOV 

1 60 

0074 

8B 

4F 

12 



MOV 

161 

0077 

8B 

57 

14 



MOV 

1 62 

007A 

97 





XCHG 

1 63 

007B 

8A 

47 

02 



MOV 


CX 
OX 
S I 
DI 
BP 
DS 
ES 

BX , CS : 
BYTE P 
NOINT 


IPTRSAVEI ;Retrieve pointer to I/O Packet. 

TR IBX. CMDl ,0 ; INIT7 

;DON'T RENABLE INTS ON INIT 


WORD PTR IBX .STATUS! ,0 ;C1ear status initially 


AL . [ BX . UNIT } 
AH, [BX. MEDIA] 
CX. [BX. COUNT] 
DX , ( BX . START ] 
AX . DI 

AL , [BX .CMD] 


; AL 
; AH 


= Unit number 
: Media descriptor 


;CX B Contains byte/sector count. 
;0X s starting Logical sector. 
.-Save Unit and Media Temporar i 1y . 
; Retrieve Command type. (1 *> 11) 


Th« Microsoft MACRO Assemblor 02-20-S4 
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1 64 
1 65 

O07E 

3C 

oc 

CMP 

166 

0080 

76 

02 

JBE 

1 67 

0082 

BO 

OD 

MOV 

1 68 
1 69 

0084 

0084 

32 

E4 

CMDOK ; 

XOR 

1 70 

0086 

D 1 

EO 

SHL 

171 

0088 

05 

OOA9 R 

ADD 

1 72 

008B 

8B 

FO 

MOV 

173 

O08D 

97 


XCHG 

1 74 

O08E 

C4 

7F OE 

LES 

1 75 
176 

009 1 

OE 


PUSH 

1 77 

0092 

1 F 


POP 

1 78 

0093 

FF 

1 4 

CALL 

1 79 

0095 

2E 

C5 IE OOOO E 

LDS 

1 80 

009A 

8 1 

4F 03 O1O0 

OR 

1 8 1 
1 82 

009F 

07 


POP 

1 83 

OOAO 

1 F 


POP 

184 

OOA1 

5D 


POP 

1 85 

OOA2 

5F 


POP 

186 

OOA3 

5E 


POP 

1 87 

OOA4 

5A 


POP 

188 

OOA5 

59 


POP 

1 89 

OOA6 

5B 


POP 

1 90 

OOA7 

58 


POP 

1 9 1 

OOA8 

CB 


RET 

192 

193 

OOA9 



DISPATCH ENDI 


PAGE 1-sl 

Interrupt routines. 


AL . 1 2 ; CHECK I N 

CMDOK :RANGE, BOUND 

AL.13 

AH . AH 
AX . 1 

AX. OFFSET DSK_TBL 
S I . AX 

AX.DI get unit and media back 

0 I . I BX . TRANS ] ;DI : transfer addr 
; ES e segment 
CS 
DS 

WORD PTR tSI] 

BX . CS : [ PTRSAVE ] 

WORD PTR ( BX . STATUS ], 1 0OH ; set done flag 

ES 
DS 
BP 
DI 
S I 
OX 
CX 
BX 
AX 
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Strategy and Software Interrupt routines. 
194 PAGE 


195 

OOA9 



DSK TBL: 




196 

OOA9 

OOOO 

E 

“ OW 

DSK__INIT 

0 

- Initialize Driver. 

1 97 

OOAB 

OODB 

R 

OW 

MEDIA CHK 

1 

- Return current media cod 

198 

OOAO 

OOE5 

R 

DW 

GET_BPB 

2 

- Get Bios Parameter Block 

199 

OOAF 

OOOO 

E 

DW 

HIOCTL 

3 

- Hard disk lOCTL 

200 

OOB 1 

OOFB 

R 

DW 

DSK READ 

4 

- Block r ead . 

201 

OOB3 

OODO 

R 

DW 

BUSY 

5 

- (Not used, return busy f 

202 

OOB5 

OOCF 

R 

OW 

RETURN 

6 

- Return status. (Not used 

203 

OOB7 

OOCF 

R 

DW 

RETURN 

7 

- Flush input buffer. (Not 

204 

OOB9 

010B 

R 

DW 

DSK WRT 

8 

- B 1 ock wr i t e . 

205 

OOBB 

0103 

R 

DW 

DSK WRTV 

9 

- Block write with verify. 

206 

OOBO 

OOCF 

R 

DW 

RETURN 

1 0 

- Return output status. 

207 

OOBF 

OOCF 

R 

OW 

RETURN 

1 1 

- Flush output buffer. (No' 

208 

OOC 1 

OOOO 

E 

DW 

HIOCTL 

1 2 

- Hard disk lOCTL 

209 

OOC3 

OOC5 

R 

OW 

CMDERR 

1 3 

- Error 


2 10 
2 1 1 


ag ) 

used . ] 
used . ) 


SUBTTL Common error and exit points. 
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212 

213 

214 

215 

216 

217 

218 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 
24 1 

242 

243 

244 


OOC5 

OOC5 2E: C5 IE OOOO E 

OOCA 81 4P 03 8003 
OOCF C3 


OODO 

OODO 2E; C5 IE OOOO E 
OODS 81 4F 03 0200 
OODA C3 


PAGE 

Common error processing routine. 
AL contains actual error code. 


Error # O * 


12 = 
command 


Write Protect violation. 

Unkown unit. 

Drive not r eady . 

Unknown command in I/O packet. 

CRC error. 

Bad drive request structure length. 
Seek error . 

Unknown media discovered. 

Sector not found. 

Printer out of paper. 

Wr it e fault . 

Read fault . 

Genera 1 f a i lure . 
error 


CMDERR : 

LDS BX , CS : [ PTRSAVE ] 

OR WORD PTR ( BX . STATUS 1 , 8003H 

RETURN; RET 


return busy 


LDS BX . CS : I PTRSAVE 1 

OR WORD PTR [ BX . STATUS ]. 200H 

RET 

SUBTTL Media check routine 
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245 




PAGE 


246 






247 




Media check 

rout i ne . 

248 




On ent r y : 


249 




AL : 

memory driver unit number. 

250 




AN : 

media byte 

251 




On exit: 


252 






253 




[ MED I 

A FLAG] s -1 (FF hex) if disk 

254 




IMEDI 

A FLAG] : 0 if don't know. 

255 




[MEDI 

A FLAG] : 1 if not changed. 

256 






257 






258 

OODB 


MEDIA CHK: 


259 

OODB 

2E: C5 IE OOOO E 


LOS 

BX . CS : I PTRSAVE ] 

260 

OOEO 

C6 47 OE 01 


MOV 

BYTE PTR I BX . TRANS ] , 1 

261 

OOE4 

C3 


RET 


262 







is changed. 


SUBTTL Build and return Bios Parameter Block for 


d i sket t e . 
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264 

265 

266 

267 

268 

269 

270 

27 1 

272 

273 

274 

275 

276 

277 

278 

279 

280 

28 1 
282 

283 

284 

285 

286 
287 


00E5 

00E5 32 E4 

00E7 D1 EO 
00E9 86 FO 

OOEB 8B 84 004C R 

OOtF 2E: C5 IE OOOO E 

OOF4 89 47 12 

OOF7 8C 4F 14 
OOFA C3 


PAGE 

Build Bios Parameter Blocks. 

On entry: ES : BK contains the address of a scratch sector buffer. 

AL : Uni t number . 

AH : Current media byte. 

On exit: Return a OWORD pointer to trie associated BP8 

in the Request packet. 


XOR AH. AH ; clear high byte 

SHL AX , 1 Shift to word offset 

MOV S I , AX 

MOV AX.WORO PTR INI_TAB[SI] ; get BPB 

LOS BX . CS : ( PTRSAVE ] 

MOV WORD PTR [ BX . COUNT ]. AX 

MOV WORD PTR ( B X . C 0 U N T 1- 2 ] . C S 

RET 

SUBTTL MSDOS 2.x Oisk I/O drivers. 


The 

Microsoft 

MACRO Assembler 

02-20-84 
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MSOOS 2.1 

Disk I/O dr i 

ver s . 

288 




PAGE 


289 






290 






29 1 




Disk READ/WRITE functions. 

292 






293 




ENTRY ; 


294 





AL : Disk I/O driver number 

295 





AH : Media byte. 

296 





CX = Number of sectors to transfer 

297 





OX : Logical starting sector. 

298 





ES;OI * Oisk transfer address 

299 






300 




EXIT: 


301 






302 





»*»*»««***«*»»**»»**»*»»««»»»»****«*««*»*******»»* 

303 






304 

OOFB 



)SK READ; 


305 

OOFB 

E8 

0167 R 

CALL 

SETPAR 

306 

OOFE 

E8 

OOOO E 

CALL 

HREAD 

307 

0101 

EB 

OE 

JMP 

SHORT COMM 

308 






309 

0103 



JSK WRTV ; 


3 1 0 

0103 

E8 

0167 R 

CALL 

SETPAR 

3 1 1 

0106 

E8 

OOOO E 

CALL 

HWRI TEV 

3 1 2 

0109 

EB 

06 

JMP 

SHORT COMM 

3 1 3 






314 

010B 



JSK WRT ; 


315 

010B 

E8 

0167 R 

CALL 

SETPAR 

3 1 6 

010E 

E8 

OOOO E 

CALL 

HWRITE 

3 1 7 






3 1 8 

0111 



:OMM: 


3 1 9 

0111 

73 

2B 

JNC 

C0MM1 exit if no error 

320 

0113 

3C 

OF 

CMP 

AL.SERR soft error 

32 1 

0 115 

74 

27 

JZ 

C0MM1 return as good 

322 

0 117 

2E 

: C5 IE OOOO E 

LOS 

BX , CS : [PTRSAVE] 

323 

01 1 C 

C7 

47 12 OOOO 

MOV 

WORD PTR [BX. COUNT]. 0 ; any error set count «0 

324 

012 1 

B9 

0102 

MOV 

CX.0102H ; assume drive not ready error 

325 

0124 

3C 

03 

CMP 

AL . DRI VEOF 

326 

0126 

74 

10 

JZ 

C0MM2 

327 

0128 

B 1 

04 

MOV 

CL. 4 ; assume CRC error 

328 

01 2A 

F6 

C4 40 

TEST 

AH . CRCER 

329 

0120 

75 

09 

JNZ 

C0MM2 

330 

01 2F 

B 1 

08 

MOV 

CL. 8 ; assume sector not found 

331 

013 1 

F6 

C4 10 

TEST 

AH , IDNF 

332 

0134 

75 

02 

JNZ 

C0MM2 

333 

0136 

B 1 

OC 

MOV 

CL.OCH set as general error 

334 

0138 


c 

:0MM2 : 


335 

0138 

09 

4F 03 

OR 

WORD PTR [BX .STATUS] ,CX 

33 6 






337 

013B 

E8 

OOOO E 

CALL 

UP^BAT ; update BAT 

338 

013E 


C 

:0MM1 : 


339 

013E 

C3 


RET 


340 






34 1 




SUBTTL 

Part i t i on Table 
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342 

343 

344 

345 

346 

347 
346 

349 

350 

35 1 

352 

353 

354 

355 

356 

357 
356 

359 

360 

36 1 

362 

363 

364 

365 

366 

367 
366 

369 

370 

37 1 

372 

373 

374 


The 

Hard 


375 

376 

377 
376 

379 

380 

38 1 

382 

383 

384 

385 

386 

387 
386 

389 

390 

39 1 

392 

393 

394 

395 

396 

397 
396 

399 

400 

40 1 

402 

403 

404 

405 

406 

407 
406 

409 

410 

41 1 

412 

413 

414 

415 

416 

417 
416 

419 

420 

42 1 

422 

423 

424 

425 

426 

427 
426 
429 


Part i t i on Table 


PAGE 


» » 


PARTITION 

This is the logical drive partitions for this OS. 

If any one of the drive is not present, the first track # 
should contain a O. (since track O will not be used for any OS) 
Note: this table will have more information about each partition. 
So. PART_SI2E will change!!! 


: 0004 
: 0006 


MNPARTS EOU 4 

PART_SI2E EOU 6 


# of max. partitions in this system 
partition info size 


01 3F 


PARTITION LABEL WORD 


013F OOOO 
0141 OOOO 
0143 OOOO 


DW O 

DW O 

DW O 


first track # 
last track # 
reserved 


0145 OOOO OOOO OOOO 
01 4B OOOO OOOO OOOO 
0151 OOOO OOOO OOOO 


DW 0,0,0 
DW 0,0.0 
DW 0.0,0 


0157 01 08 OF 06 OO 04 

OB 02 

015F 09 10 07 OE 05 OC 

03 OA 


RDXLT DB 


1,8,15.6.13,4,11,2 


DB 9,16.7,14,5,12.3,10 
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SETPAR - set up disk interface parameters 


ENTRY : 
EXIT: 


AL : unit code 

DX = logical sector P 

BL = sector # 

BH : surface # 

DX s cy 1 i nder P 

(XLT__F) s 1 og i ca 1 /phys i ca 1 flag 


« * * * » 


0167 SETPAR: 


01 67 

C6 

06 

OOOO 

E 0 1 

MOV 

BYTE PTR XLT 

_F , 1 ; assume using translate table 

01 6C 

6B 

F2 



MOV 

S I . DX 

; save sector # 

01 6E 

E8 

01 A7 R 


CALL 

GETFTN 

; get partition first track # 

0171 

8B 

C6 



MOV 

AX , S I 

get sector # 

0173 

8 1 

E6 

OOOF 


AND 

S I , OFH 

, form logical sector # 

0177 

6A 

9C 

0157 

R 

MDV 

BL.BYTE PTR 

RDXLTlSI] get sector # from translate 

01 7B 

0 1 

E8 



SHR 

AX , 1 

; shift to track offset 

01 7D 

01 

E8 



SHR 

AX . 1 


01 7F 

D 1 

E6 



SHR 

AX , 1 


0161 

01 

E8 



SHR 

AX . 1 


0163 

30 

0002 


CMP 

AX . 2 

; check within first 2 track 

0166 

70 

09 



JGE 

SETPAR1 


0168 

6B 

DE 



MOV 

BX , SI 

no skew on first 2 track 

01 6A 

FE 

C3 



INC 

BL 

; sector # is base 1 

01 6C 

C6 

06 

OOOO 

E OO 

MOV 

BYTE PTR XLT 

_F , 0 ; don't use translate table 

019 1 





SETPAR 1 : 



019 1 

03 

DO 



ADD 

DX , AX 

add partition offset 

0193 

69 

1 6 

OOOO 

E 

MOV 

TEMP TRK.DX 

; save track # in case error 

0197 

88 

IE 

OOOO 

E 

MOV 

TEMP^SEC , BL 

; save sector # 






; JMP 

CLTPN 



CLTPN - Convert Logical Track # to Physical sur f ace/cy 1 i nder # 

ENTRY: DX = logical track # 

EXIT: BH = surface n 

OX : cy 1 i nder # 

USE: NONE 


01 9B 

019B 6A FA 
0190 60 E7 03 

01A0 01 EA 


CLTPN : 

get low track byte 
keep surface only 
get rid of surface bits 


I»IU T B n , U L 

AND BH.03H 

SHR DX,1 
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SHR DX , 1 

RET 


430 01A2 01 EA 

431 01A4 C3 

432 
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Part i t i or 

Teble 


433 





PAGE 


434 





»*»»*««»*«»»«« 

**»m**************************»****m************* 

435 







436 





GETFTN 

- GET partition First Track Number 

437 







438 





ENTRY : 


439 






GETFTN; AL = hard disk partition # (from O to MNPARTS-1) 

440 






GETFTNO; AL = MS-DOS disk drive offset 

44 1 





EXIT: 

DX : Start track F for this partition 

442 






2 flag is not set if the partition is not exist 

443 






(start track # = 0), or wrong drive # 

444 






BX : partition entry start addr 

445 





USES ; 

AX, BX 

446 







447 





*««*»»«»»*««*« 

**»m***»*****************M*********»**9********** 

448 







449 

01 A5 




:etftno ; 


450 

01 A5 

2C 

04 


SUB 

AL.HDISK ; set to Wini offset 

45 1 

01 A7 




SETFTN : 


452 

01 A7 

33 

02 


XOR 

DX,DX ; assume wrong drive # 

453 

01 A9 

3C 

04 


CMP 

AL.MNPARTS ; within limit 

454 

01 A6 

73 

05 


JNB 

GETFTN1 

455 

01 AO 

E8 

0165 R 


CALL 

GETPEA get partition start addr 

456 

01 BO 

86 

17 


MOV 

DX.[BX] ; get start track # 

457 

01 B2 




;etftni ; 


458 

0162 

23 

02 


ANO 

DX.DX ; set Z flag 

459 

0164 

C3 



RET 


460 







46 1 







462 







463 





*««»»«««»*»**« 

*«»«»«»««««»»»»*»*»««»**««»»»*»*«««»»««»»«»««»*»« 

464 







465 





cetpea 

- GET Partition Entry Addr 

466 







467 





ENTRY : 

AL s hard disk partition # (from 0 to MNPARTS-1) 

468 





EXIT: 

AX : BX s partition entry start addr 

469 





USES : 

AX , BX 

470 







47 1 





*****««»*«««»«**«***»»»»»«»«»«»«»»»»«*»«»«««««*««»««»«»»«»«**»» 

472 







473 

0165 




SETPEA : 


474 

0165 

63 

06 


MOV 

BL,PART_SIZE ; get partition sixe 

475 

O 1 67 

F6 

E3 


MUL 

BL ~ ; set to partition entry offset 

476 

0169 

05 

013F R 


ADO 

AX, OFFSET PARTITION ; add start addr 

477 

01 BC 

86 

06 


MOV 

BX,AX ; be nice to BX 

478 

01 BE 

C3 



RET 


479 







460 







46 1 

01BF 



( 

:ODE ENDS 


462 





END 





The Microsoft MACRO Assembler 

02-20-84 

PAGE 

Symbols - 1 

Hard Disk driver 





Structures and records: 





Name 

Width 

# fields 



Sh i ft 

Width 

Mask 

Initial 

DBP 

©©IS 

©OOB 



SECS2 

00©© 




ALLOC 

0©©2 




RESSEC 

©OOS 




FATS 

0©©5 




MAXDIR 

©0©6 




SECTORS 

©0©8 




MEDIAID 

©0©A 




FATSEC 

©0©B 




SECTRK 

©0©D 




HEADS 

©OOF 




HIDDEN 

0©1 1 




lODAT 

©016 

0009 



CMOLEN 

©OO© 




UNIT 

©©©1 




CMD 

0©©2 




STATUS 

o©©s 




MEDIA 

©©©D 




TRANS 

0©©E 




COUNT 

©012 




START 

©014 




Segments and groups: 





Name 

Si le 

align 

combine 

c lass 

CGROUP 

GROUP 




CODE 

©1 BF 

BYTE 

PUBLIC 

' CODE ' 

Symbo 1 s : 





Name 

Type 

Value 

At t r 


ABRTC 

Number 

©004 



AST OFF 

Number 

©026 



ATRETRY 

Number 

©©©0 



BADBD 

Number 

©08© 



BAT OFF 

Number 

©012 



BID AST. . /. 

Number 

©©05 



BID BAT 

Number 

©0©2 



BID BOT 

Number 

©008 



BID DPD 

Number 

©©©3 



BID HOM 

Number 

©©©1 



BID OSN 

Number 

©004 



BID PAS 

Number 

©©06 



BID PBT 

Number 

©0©7 



BID UKN 

Number 

©OO© 



BIT© 

Number 

©©©1 



BIT1 

Number 

©0©2 



BIT15 

Number 

8©©0 



BIT2 

Number 

©©04 
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BITS 

Number 

©0©8 



BIT4 

Number 

©Ol© 



BITS 

Number 

©02© 



BITS 

Number 

©04© 



BIT7 

Number 

©08© 



BK EC OFF 

Number 

©0©8 



bk'~lbn off 

Number 

©OOS 



bk"“mec”off 

Number 

©OOS 



BOOT OFF 

Number 

©021 



BUSY 

L NEAR 

©OO© 

CODE 


CBSY 

Number 

©08© 



CBSY2 

Number 

©©01 



CLRIL 

Number 

©004 



CLRSPL 

Number 

©0©8 



CLTPN 

L NEAR 

©1 SB 

CODE 


CMDERR 

L NEAR 

©OCS 

CODE 


CMD IP 

Number 

©002 



CMDOK 

L NEAR 

©084 

CODE 


COMM 

L NEAR 

©111 

CODE 


COMM1 

L NEAR 

©1 3E 

CODE 


C0MM2 

L NEAR 

©138 

CODE 


CPM8680 

Number 

©001 



CR 

Number 

OOOD 



CRCER 

Number 

©040 



CTRL © 

Number 

©01 1 



CTRL S 

Number 

©013 



CTRL~2 

Number 

©01 A 



CYLDH 

Number 

©065 



CYLDL 

Number 

©064 



DAMNF 

Number 

©001 



DATA 

Number 

©06© 



DATARQ 

Number 

©008 



DISKDF 

Number 

©005 



DISPATCH 

F PROC 

©054 

CODE 

Length sooss 

DPDE FLAG 

Number 

OOO© 



dpde“ftn 

Number 

©OOC 



DPDE INIT 

Number 

©OF© 



DPDE LTN 

Number 

©OOE 



dpde”lu 

Number 

©001 



DPDE OFF 

Number 

©02© 



OPDE^OST 

Number 

©OOB 



dpde""pn 

Number 

©002 



dpde“pon 

Number 

©OOA 



DPD OFF 

Number 

©017 



DPD“sTART OFF 

Number 

©02© 



DRDY . . “ 

Number 

©04© 



DRDY2 

Number 

©04© 



DRIVE© 

Number 

©OO© 



DRIVE1 

Number 

©008 



DRIVE2 

Number 

©01© 



DRIVES 

Number 

©018 



DRIVEDF 

Number 

©003 



DRIVEM 

Number 

©018 



DRVSEL 

Number 

©001 



DSK INIT 

L NEAR 

©OO© 

CODE 

External 
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DSK INT 

L NEAR 

0054 

CODE 

Global 

DSK READ 

L NEAR 

OOFB 

CODE 


DSK TBL 

L NEAR 

OOAB 

CODE 


DSK WRT 

L NEAR 

010B 

CODE 


DSK WRTV 

L NEAR 

0103 

CODE 


DSTATO 

Number 

006B 



DSTAT1 

Number 

0088 



DWRTF 

Number 

0020 



DWRTF2 

Number 

0020 



ERRF 

Number 

0001 



ERRDR 

Number 

006 1 



FALSE 

Number 

OOOO 



FMTTRK 

Number 

0050 



GETFTN 

L NEAR 

01 A7 

CODE 

Global 

GETFTNO 

L NEAR 

01 A5 

CODE 

Global 

GETFTN1 

L NEAR 

01 B2 

CODE 


GETFEA 

L NEAR 

01 B5 

CODE 

Global 

GET BPS 

L NEAR 

OOE5 

CODE 


HDIR 

Number 

0006 



HOISK 

Number 

0004 



MDSKO 

L 00 13 

OOOO 

CODE 

Globa 1 

HDSK1 

L 00 13 

00 13 

CODE 


HDSK2 

L 00 13 

0026 

CODE 


HDSK3 

L 00 13 

0039 

CODE 


HEADO 

Number 

OOOO 



HEAD02 

Number 

OOOO 



HEAD 1 

Number 

0001 



HEAD 12 

Number 

0002 



HEAD2 

Number 

0002 



HEAD22 

Number 

0004 



HEADS 

Number 

0003 



HEAD32 

Number 

0006 



HEADM 

Number 

0007 



HEADM2 

Number 

OOOE 



HFORMAT 

L NEAR 

OOOO 

CODE 

Externa 1 

HINIT 

L NEAR 

OOOO 

CODE 

Ext er na 1 

HIOCTL 

L NEAR 

OOOO 

CODE 

Ext er na 1 

HIVEC A 

Number 

01 14 



HIVEC B 

Number 

0294 



HMCHK 

L NEAR 

OOOO 

CODE 

Externa 1 

HREAD 

L NEAR 

OOOO 

CODE 

Ext er na 1 

HVDISK 

L NEAR 

OOOO 

CODE 

Ext er na 1 

HWRITE 

L NEAR 

OOOO 

CODE 

Externa 1 

HWRI TEV 

L NEAR 

OOOO 

CODE 

Externa 1 

IDBIT 

Number 

OOEO 



IDBITV 

Number 

OOAO 



IDNF 

Number 

OO 10 



INI TAB 

L WORD 

004C 

CODE 

G 1 oba 1 

INTHDL 

L NEAR 

OOOO 

CODE 

Ext er na 1 

LF 

Number 

OOOA 



LINDEX 

Number 

0002 



LSTEPP 

Number 

0004 



MEDIA CHK 

L NEAR 

OODB 

CODE 


MNPARTS 

Number 

0004 


Global 

MSCTF 

Number 

0004 
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MSDOS 

Number 

0002 



NCYLD OFF 

Number 

0040 



NDRV 

V BYTE 

OOOO 

CODE 

External 

NOINT 

L NEAR 

0069 

CODE 


NT AST OFF 

Number 

0020 



NUMHEAO 

Number 

0004 



OSN OFF 

Number 

OO 1 C 



PARTITION 

L WORD 

0 1 3F 

CODE 

Global 

PART FTN .... 

Number 

OOOO 



PART LTN 

Number 

0002 



PART PAS 

Number 

0004 



PART SIZE 

Number 

0006 


Global 

PASE OFF 

Number 

0005 



PAS ASN 

Number 

0004 



PAS ATN 

Number 

0003 



PAS BSN 

Number 

0002 



PAS BTN 

Number 

OOOO 



PRE READ 

Alias 

FALSE 



PTRSAVE 

V DWORD 

OOOO 

CODE 

Ext er na 1 

RDBASE 

Number 

0060 



RDCMO 

Number 

0067 



RDCMD2 

Number 

0068 



ROINTF 

Number 

0008 



RDREAD 

N umber 

0020 



RDSTAT 

Number 

0067 



RDWRITE 

Number 

0030 



RDXLT 

L BYTE 

0157 

CODE 

Global 

RESTOR 

Number 

OO 10 



RETURN 

L NEAR 

OOCF 

CODE 


SBUFR 

Number 

OOO 1 



SCANIO 

Number 

0040 



SCTEXT 

Number 

0080 



SDH 

Number 

0086 



SECPTRK 

N umber 

OO 10 



SECS IZE 

Number 

0200 



SECTC. . 

Number 

0062 



SECTN 

Number 

0063 



SECTSZ 

N umber 

0060 



SEEK 

Number 

0070 



SEEKC 

Number 

0010 



SEEKC2 

Number 

00 10 



SERR 

Number 

OOOF 



SETPAR 

L NEAR 

0 1 67 

CODE 


SETPAR1 

L NEAR 

019 1 

CODE 


SINIT 

Number 

0002 



SSCTF 

Number 

OOOO 



SSZ128 

Number 

0060 



SSZ1K. . 

Number 

0040 



SSZ2S6 

Number' 

OOOO 



SSZ512 

Number 

0020 



STEPRO 

Number 

OOOO 



STEPR1 

Number 

OO01 



ST.EPR2 

Number 

0002 



STEPR3 . 

Number 

0003 



STEPR4 

Number 

0004 
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STEPRS Number 0005 

STEPR6 Number 0006 

STEPR7 Number 0007 

STEPRS Number 0008 

STEPRS Number 0009 

STEPRA Number OOOA 

STEPRS Number OOOB 

STEPRC Number OOOC 

STEPRD Number OOOD 

STEPRE Number OOOE 

STEPRF Number OOOF 

STEPR OFF Number 004C 

ST_AST OFF Number 002B 

TEMP SEC V BYTE OOOO CODE 

TEMP”tRK V WORD OOOO CODE 

TRK02 Number 0080 

TRKOE Number 0002 

TRUE Number - OO0 1 

UP_BAT L NEAR OOOO CODE 

WGATE Number 0010 

WINI OFFSET Number 0094 

WINi'SEG Number 0096 

WPC__OFF Number 004A 

WPRCMP Number 0061 

WPRSNT Number 0001 

WTVERR Number OOOD 

XBB BO Number 0008 

XBB~BS Number OOOA 

XBB~CN Number 0004 

XBB“dISKF Number OOOO 

XBB~DSN Number 0003 

XBB ERRC Number OOOC 

XBB~LDN Number 0001 

XBB_SC Number 0006 

XBB__SN Number 0002 

XCPRSNT Number 0002 

XLT F V BYTE OOOO CODE 


Warning Severe 
Errors Errors 
O O 


Hard Disk driver 

Symbol Cross Reference (# is definition) 


ABRTC 29# 

ALLOC 38# 

AST__OFF 29# 

ATRETRY 29# 

BADBD 29# 

BAT_OFF 29# 

BID^AST 29# 

BID BAT 29# 

BID”bOT 29# 

BID”dPD 29# 

BID__H0M 29# 

BID_OSN 29# 

BID_PAS 29# 

BID__PBT 29# 

B1D__UKN 29# 

BITO 29# 

BIT1 29# 

BIT15 29# 

BIT2 29# 

BIT3 29# 

BIT4 29# 

BITS 29# 

BIT6 29# 

BIT7 29# 

BK_EC OFF 29# 

BK__LBN OFF 29# 

BK MEC”OFF 29# 

BOOT OFF 29# 

BUSY“ 201 239# 

CBSY 29# 

CBSY2 29# 

CGROUP 13 15 15 15 

CLRIL 29# 

CLRSPL 29# 

CLTPN 426# 

CMD 115# 153 163 

CMDERR 209 23 1# 

CMDIP 29# 

CMDLEN 113# 

CMDOK 1 66 1 68# 

CODE 13 14# 14 481 

COMM 307 312 3 18# 

C0MM1 319 32 1 338# 

C0MM2 326 329 332 334# 

COUNT 123# 160 283 284 

CPM8680 29# 

CR 29# 

CRCER 29# 328 

CTRL_0 29# 

CTRL_S 29# 

CTRL__2 29# 

CYLOIT 29# 

CYLDL 29# 

DAMNF 29# 


Ext er na 1 
Ext er na 1 


Ext er na 1 


Ext erna 1 


Cr ef - 1 


1 5 


323 



Hard DISK drivar 


Symbol Cross Roforonco 


[0 is dofinition) Cref-2 


DATA .... 
OATARd . . . 

DBP 

DISKDF . . . 

DISPATCH . . 

DPDE FLAG. . 

dpde“ftn . . 
dpde”init. . 
DPDe^LTN . . 

dpde“lu. . . 

DPDE OFF . . 

dpde““ost . . 

DPDE*”PN. . . 

dpde”pon . . 

DPO OFF . . . 

DPO^START OFF 
DROV . . “ . 

DRDY2. . . . 

DRIVED . . . 

DRIVE1 . . . 

DRIVE2 . . . 

DRIVES . . . 

DRIVEOF. . . 

DRIVEN . . . 

DRVSEL . . . 

DSK__INIT . . 

OSK INT . . 

DSK~*READ . . 

osk“tbl. . . 

osk“wrt . . . 

dsk“vyrtv . . 

DSTATO . . . 

DSTAT1 . . . 

DWRTF .... 
DWRTF2 . . . 

ERRF .... 
ERROR. . . . 

FALSE. . . . 

FATS .... 
FATSEC . . . 

FMTTRK . . . 

CETFTN . . . 

CETFTNO. . . 

GETFTN 1 . . . 

CETPEA . . . 

CET_BPS . . . 

HD I R . . . . 

HDISK. . . . 

HDSKO. . . . 

HDSK 1 . . . . 

HDSK2. . . . 

HDSK3. . . . 

HEADO. . . . 


29# 


29# 


33# 

52 

29# 


1 40# 

193 

29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 


29# 

325 

29# 


29# 


1 9# 

1 96 

27 

142# 

200 

304# 

1 7 1 

1 95# 

204 

3 1 4# 

205 

309# 

29# 


29# 


29# 


29# 


29# 


29# 


29# 

29 

40# 


44# 


29# 


25 

393 

25 

449# 

454 

457# 

25 

455 

198 

276# 

29# 


29# 

450 

27 

54# 

66# 

1 04 

78# 

1 05 

90# 

106 

29# 
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(# is definition) Cref-3 


HEA0O2 29# 

HEAD 1 29# 

HEAD12 29# 

HEAD2 ... 29# 

HEAD22 29# 

HEAD3 29# 

HEAD32 29# 

HEADM 29# 

HEADM2 29# 

HEADS 49# 

HFORMAT 18# 

HIDDEN SO# 

HINIT 18# 

HIOCTL 21# 199 208 

HIVEC__A 29# 

HIVEC_B 29# 

HMCHk” 18# 

HREAD 17# 306 

HVDISK 19# 

HWRITE 17# 316 

HWRITEV 17# 311 

IDBIT 29# 

IDBITV 29# 

IDNF 29# 331 

INI TAB 24 103# 280 

INTHDL 19# 

lODAT 112# 125 

LF 29# 

LINOEX 29# 

LSTBPP 29# 

MAXDIR 41# 

MEDIA 121# 159 

MEDIAID 43# 

MEDIA__CHK 1 97 258# 

MNPARTS 26 357# 453 

MSCTF 29# 

MSDOS 29# 

NCYLD_0FF 29# 

NDRV 20# 

NOINT 1 54 156# 

NT AST_OFF 29# 

NUMHEAD 29# 

OSN__OFF 29# 

PARTITION 26 360# 476 

PART FTN 29# 

PART”lTN 29# 

PART^PAS 29# 

PART”sI2E 26 358# 474 

PASE”oFF 29# 

PAS ASH 29# 

PAS~ATN 29# 




Hard Disk drWar 


Symbol Cross kaforanca 


(# fs definition) Craf-4 


PAS BSN. 
kAS~BTN . 
PRE-READ 
PTRSAVE . 

RDBASE . 
RDCMD . . 
RDCHD2 . 
RDINTP . 
RDREAD . 
RDSTAT . 
RDWRITE . 
RDXLT. . 
RESSEC . 
RESTOR . 
RETURN . 


29# 

29# 

29# 


20# 

152 

179 

232 

240 

259 

282 

322 







29# 

29 

29 

29 

29 

29 

29 

29 

29 

29 

29 

29 

29 

29 


29# 

29# 

29# 

29# 

29# 

29# 

24 371# 397 

39# 

29# 

202 203 206 207 234# 


SBUFR 29# 

SCANID 29# 

SCTEXT 29# 

SDH 29# 

SECPTRK 29# 

SECSIZE 29# 

SECS2 37# 

SECTC 29# 

SECTN 29# 

SECTORS 42# 

SECTRK 46# 

SECTS! 29# 

SEEK 29# 

SEEKC 29# 

SEEKC2 29# 

SERR 29# 320 

SETPAR 305 310 315 390# 

SETPAR1 404 408# 

SINIT 29# 

SSCTF 29# 

SSZ128 29# 

SSZ1K 29# 

SSZ256 29# 

SSZ512 29# 

START 124# 1 6 1 

STATUS 116# 156 180 233 24 1 335 

STEPRO 29# 

STEPR1 29# 

STEPR2 29# 

STEPR3 29# 

STEPR4 29# 

STEPR5 29# 

STEPR6 29# 

STEPR7 29# 

STEPR8 29# 

STEPR9 29# 

STEPRA 29# 

STEPRB 29# 

STEPRC 29# 

STEPRD 29# 


Hard Disk driver 


Symbol Cross Reference 


(# is definition) Cref-5 


STEPRE 29# 

STEPRF 29# 

STEPR__OFF 29# 

ST AST OFF 29# 


TEMP SEC 22# 411 

TEMP_TRK 22# 410 

TRANS 122# 174 260 

TRK02 29# 

TRKOE 29# 

TRUE 29# 29 


UNIT . 
UP_BAT 


114# 158 

21# 337 


WGATE. . . 

WINI_OFFSET 
WINI SEC . 
WPC OFF . . 

WPRCMP . . 

WPRSNT , . 

WTVERR . . 


29# 

29# 

29# 

29# 

29# 

29# 

29# 


XBB BO 29# 

XBB'bS 29# 

XBB_CN 29# 

XBB_DISKF 29# 

XBB__DSN 29# 

XBB ERRC 29# 

XBB^LDN 29# 

XBB__SC 29# 

XBB SN 29# 

XCPRSNT 29# 

XLT F 20# 


39 1 


407 
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PACE 


1 - 1 


1 

2 

3 

9 

10 
1 1 
1 2 

13 

1 4 OOOO 

15 
1 6 
1 7 
1 8 

1 9 
20 

2 1 
22 

23 

24 

25 

26 

27 

28 
29 


PAGE 80.132 

TITLE Hard Disk I/O Control Functions 
NAME KIOCTL 


COMPANY CONFIDENTIAL 

Copyright (C) 1983 Digital Equipment Corporation 

: All rights reserved. 

Hard Disk I/O Control Functions 
08/30/83 

CGROUP GROUP CODE 

CODE SEGMENT BYTE PUBLIC 'CODE' 

ASSUME CS:CGROUP. DS:CCROUP. ESrCGROUP, SS : CGROUP 

EXTRN HREAD:NEAR. HWRITEiNEAR. HWRITEV:NEAR 

EXTRN HFORMAT r NEAR . HINITiNEAR, HMCHK ; NEAR 

EXTRN HVDISK:NEAR, INTHDL:NEAR. DSK INIT;NEAR 
EXTRN XLT_F:BYTE. RDXLT:BYTE "■ 

EXTRN GETFTN;NEAR. GETFTNO : NEAR . GETPEA:NEAR, CLTPNrNEAR 
EXTRN PARTITION ;WORD 

PUBLIC HIOCTL 

LIST 


SUBTTL Hard disk I/O Control functions 


The Microsoft MACRO Assembler 02*20-84 PACE 1-2 

Hard Disk I/O Control Functions 

Hard disk I/O Control functions 


30 

3 1 

32 

33 

34 

35 

36 

37 

38 

39 

40 

4 1 

42 

43 

44 

45 

46 

47 

48 

49 

50 

5 1 

52 

53 

54 

55 

56 

57 

58 

59 


OOOO 

OOOO E8 0079 R 
0003 80 FC FF 

0006 75 08 


0008 80 FF 40 

OOOB 7C OB 
OOOO EB OD 90 


0010 80 FC 04 

0013 7C 03 
0015 EB 05 90 


0018 

0018 B8 0005 
001B C3 


PAGE 

HIOCTL - Hard disk I/O Control functions 


HIOCTL : 

; XB_D ISK : 

CALL 

CMP 

JN2 


CET_REC 
AH , OFFH 
XBDSKl 


physical disk operation 

CMP 
JL 
JMP 

logical disk operation 


BH . 40H 
XB__FLOPPY 
W DISK 


CP/M label 

get all information 

check logical or physical operation 


check floppy or Winni 
it's f 1 oppy 
it's Wi n i 


XBOSKI : CMP 

JL 
JMP 


AH . HDISK 
XB_F LOPPY 
W DISK 


; check floppy or Winnie 
: disk i s Wi nn i e 


XB FLOPPY: 

~ MOV 

RET 


hard disk driver will not do the hard work for floppy 

AX.OISKOF set error flag to disk deffective 
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Hard disk I/O Control functions 

60 PAGE 


61 

»#«»»«»*»«»«***»«******«»**»«*«**»«*«»»»«*»»*»**»«»»**» 

62 





63 

W_DISK 

- Wini 

XBIOS functions 

64 





65 

ENTRY : 




66 


AL 

t 

d i sk f unct i on 

67 


AH 

s 

MS-DOS logical disk drive # 

68 



s 

OFFH if physical operation 

69 


BL 

s 

sector # 

70 


BH 

3 

high 4 nibbles - drive P 

71 




low 4 nibbles s side or surface # 

72 


OX 


track # if logical, cylinder # if physical 

73 


CX 

s 

sector count 

74 


DI 

s 

buffer offset 

75 


ES 

r 

buffer segment 

76 

EXIT : 

AX 

t 

error code defined in Wini disk driver spec 

77 





78 

»*»*«*»*««»«*»«»««*»*«»«»«»«»««»»»»»*»»*»«»»»»»«*»«»»«« 


79 


80 

001 C 



W_D I S K : 




81 

001 C 

C6 

06 OOOO E OO 


MOV 

BYTE PTR XLT F.O 

i assume physical operation 

82 

002 1 

80 

FC FF 


CMP 

AH . OFFH 

check physical or logical 

83 

0024 

74 

26 


J2 

WO ISK2 

it's phys i ca 1 

84 








85 




; 

1 og i ca 1 

d i sk operat i on 


86 








87 

0026 

50 



PUSH 

AX 

save f unct ion # 

88 

0027 

53 



PUSH 

BX 

save sector # 

89 

0028 

8B 

F2 


MOV 

S I . OX 

save logical track # 

90 

002A 

83 

FE 02 


CMP 

SI . 2 

check if first 2 tracks? 

9 1 

0020 

72 

05 


JB 

WO I SKI 


92 

002F 

C6 

06 OOOO E 01 


MOV 

BYTE PTR XLT_F , 1 

set logical flag 

93 

0034 



WO I SKI : 




94 

0034 

8A 

C4 


MOV 

AL . AH 

get MS-DOS drive # 

95 

0036 

E8 

OOOO E 


CAL L 

CETFTNO 

get partition first track # 

96 

0039 

5B 



POP 

BX 

restore sector # 

97 

003A 

74 

24 


J2 

WO ISK 1 0 

error if drive not exist 

98 

003C 

03 

06 


ADD 

OX , S I 

add start track # 

99 

003E 

F6 

06 OOOO E FF 


TEST 

XLT F.OFFH 

IF WE'RE NOT SUPPOSED TO SKEW. 

1 OO 

0043 

74 

03 


JZ 

WDISK3 

DONT 

101 

0045 

E8 

0065 R 


CALL 

DO__XLT 

XLT the first sector # 

102 

0048 



WDISK3 : 




1 03 





CALL 

DO PASX 

check if bad sector 

104 

0048 

E8 

OOOO E 


CAL L 

CLTPN 

: convert logical track to physical 

105 








1 06 

004B 

58 



POP 

AX 

restore function F 

107 








108 





physical disk operation 


109 








1 10 

004C 



WO 1SK2 : 




1 1 1 

004C 

80 

E7 OF 


AND 

BH . OFH 

; physical only drive O exist 

1 1 2 

004F 

98 



CBW 



1 13 

0050 

0 1 

EO 


SHL 

AX . 1 

word offset 

1 14 

0052 

8B 

FO 


MOV 

S I , AX 
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02 

I/O 


20-84 
Cont r o 1 


PAGE 

f unct i ons 


1 - 4 


115 0054 

116 0058 

117 005C 

118 005F 
1 1 9 

120 0060 

121 0060 

122 0061 

123 0064 

124 
1 25 
126 
1 27 
128 
1 29 
1 30 

131 0065 

132 0065 

133 0067 

134 0068 

135 006C 

136 
1 37 

138 0060 

139 006F 

140 0071 

141 0073 

142 0075 

143 0077 


FF 94 0060 R 
C5 3E 0095 R 
89 45 OC 
C3 


58 

B8 0005 
C3 


32 FF 
4B 

8A 9F OOOO E 
C3 


OOOO E 
OOOO E 
OOOO E 
OOOO E 
OOOO E 
OOOO E 


CALL 

LOS 

MOV 

RET 


WORD PTR W_DISKFlSIl 
DI . TEMP_PTR ; get 

WORD PTR [DI.XBB_ERRC 


; do it 
pointer back 

,AX set error code 


WO I S K 1 0 


POP 

MOV 

RET 


AX 

AX , 0 ISKDF 


logical drive not exist 

set error flag to disk deffective 


DO 


XLT 


do translate for 


the first sector number 


ENTRY: BL 
EXIT: BL 
USE: BX 


logical sector number **base 1 
sector number after skewing 


XOR 

DEC 

MOV 

RET 


BH . BH 
BX 

BL.BYTE PTR 


; clear 
; make 
ROXLTIBX ] 


high byte 
t base O 
; set logical 


sector # 


DW 

DW 

DW 

DW 

DW 

DW 


HREAO 
HWR I T E 
HWRI TEV 
HFORMAT 
HMCHK 
HVDISK 
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144 

FACE 




14B 


»**««***«»»**»»»*»*««*»»**»**«*»«*» 

146 





147 

GET^REG 

- get 

all block information into registers 

1 48 





1 49 

ENTRY : 

ES 

: DI 

3 block pointer 

1 80 

EXIT : 

AL 

t 

d i sk f unct i on 

1 8 1 


AH 

3 

MS-DOS logical disk drive # 

182 



3 

OFFH if physical operation 

153 


BL 

3 

sector # 

184 


BH 

3 

high 4 nibbles < physical drive # 

IBS 




low 4 nibbles * side or surface # 

1S6 


DX 

3 

track or cylinder # 

187 


CX 

3 

sector count 

188 


DI 

3 

buffer offset 

189 


ES 

» 

buffer segment 


1 60 
1 62 


1 63 

0079 





GET REG: 




1 64 

0079 

89 

3E 

0095 

R 

“ MOV 

WORD FTR [TEMP PTRJ.DI 


save pointer 

1 66 
1 66 
1 67 

0070 

8C 

06 

0097 

R 

MOV 

WORD FTR [ TEMP”pTR + 2 1 , ES 



008 1 

26 

8B 

05 


MOV 

AX , ES : XBB DISKF ( DI ] 

get 

logical disk # and disk function 

1 68 

0084 

26 

8B 

5D 

02 

MOV 

BX , ES : XBB SN [ D I ] 

get 

dr i ve/ sur f ace # and sector # 

1 69 

0088 

26 

8B 

55 

04 

MOV 

DX,ES ;XBB~'CN[DI 1 

got 

track (cylinder) # 

1 70 

ooac 

26 

8B 

40 

06 

MOV 

CX , ES : XBB'^SC [ DI ] 

got 

sector count 

1 7 1 

0090 

26 

C4 

7D 

08 

LES 

DI,ES:DWORD FTR XBB_BO[DI 

1 

get buffer offset 

1 72 

0094 

C3 




RET 




1 73 










1 74 

0095 

OO 

OO 

OO OO 

TEMP__PTR 

DD 0 




1 76 

176 0099 CODE ENOS 

177 END 
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Segments and groups; 

Name Size align combine class 


CGROUP CROUP 

CODE 0099 BYTE PUBLIC 'CODE' 


Symbo 1 s : 


N 


a m e 


Type Value Attr 


ABRTC. . . 

AST_OFF. . 
ATRETRY. . 
BAD80. . . 

BAT__OFF. . 
BID_AST. . 
B1D__BAT. . 
BID BOT. . 

bid“dpd. . 

BID~HOM. . 
BID_OSN. . 
BID_PAS. . 
BIO PBT. . 
BID~UKN. . 
BITO . . . 

B I T 1 . . . 

B I T 1 5 . . . 

BIT2 . . . 

BITS . . . 

BIT4 . . . 

BITS . . . 

BIT6 . . 

BIT7 . . . 

BK_EC OFF. 
BK_LBN__OFF 
BK_MEC_OFF 
BOOT__OFF . 
CBSY . . . 

CBSY2. . . 

CLRI L . . . 

CLRSPL . . 

CLTPN, . . 

CMDIP. . . 

CPM6680. . 

CR . . . . 

CRCER. . . 

CTRL 0 . . 

ctrl""s . . 
CTRL”! . - 

CYLDH. . . 

CYLDL. . . 

DAMNF. . . 

DATA . . . 

DATARO . ■ 


Number 0004 
Number 0026 
Number OOOO 
Number 0080 
Number 0012 
Number 0005 
Number 0002 
Number 0008 
Number 0003 
Number 0001 
Number 0004 
Number 0006 
Number 0007 
Number OOOO 
Number 0001 
Number 0002 
Number 8000 
Number 0004 
Number 0008 
Number OO 1 O 
Number 0020 
Number 0040 
Number 0080 
Number 0008 
Number 0003 
Number 0006 
Number 0021 
Number 0080 
Number 0001 
Number 0004 
Number 0008 
L NEAR OOOO 
Number 0002 
Number 0001 
Number OOOD 
Number 0040 
Number OO 1 1 
Number 0013 
Number 001A 
Number 006S 
Number 0064 
Number 0001 
Number 0060 
Number 0008 


CODE External 
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OISKDF . . . 

DO XLT . . . 

OPDE FLAG. . 
DPOE^FTN . . 

dpde“init. . 

DPDE~LTN . . 

DPDE~LU. . . 

OPDE OFF . . 

dpde“ost . . 

DPOE^PN. . . 

DPOE^PON . . 

DPD_OFF. . . 

DPD^START OFF 
ORDY . . ” . 

DRDY2. . . . 

DRIVEO . . . 

0RIVE1 . . . 

DRIVE2 . . . 

DRIVES . . . 

ORIVEDF. . . 

DRIVEM . . . 

DRVSEL . . . 

DSK__INIT . . 

DSTATO . . . 

0STAT1 . . . 

DWRTF. . . . 

DWRTF2 . . . 

ERRF .... 
ERROR. . . . 

FALSE. . . . 

FMTTRK . . . 

GETFTN . . . 

GETFTNO. . . 

GETPEA . . . 

GET_REG. . . 

HDIR .... 
HDISK. . . . 

HEADO. . . . 

HEAD02 . . . 

HEAD1 .... 
HEAD12 . . . 

HEAD2 .... 
HEAD22 . . . 

HEADS. . . . 

HEADS2 . . . 

HEADM. . . . 

HEADM2 . . . 

HFORMAT. . . 

HINIT . . . . 

HIOCTL . . . 

HIVEC_A. . . 

HIVEC B. . . 

hmchkT . . . 

HREAD. . . . 

HVDISK . . . 


Number 

OOOS 


L NEAR 

0065 

CODE 

Number 

OOOO 


Number 

OOOC 


Number 

OOFO 


Number 

OOOE 


Number 

0001 


Number 

0020 


Number 

OOOB 


Number 

0002 


Number 

OOOA 


Number 

0017 


Number 

0020 


Number 

0040 


Number 

0040 


Number 

OOOO 


Number 

0008 


Number 

00 10 


Number 

0018 


Number 

0003 


Number 

0018 


Number 

OOO 1 


L NEAR 

OOOO 

CODE 

Number 

0068 


Number 

0069 


Number 

0020 


Number 

0020 


Number 

000 1 


Number 

006 1 


Number 

OOOO 


Number 

0050 


L NEAR 

OOOO 

CODE 

L NEAR 

OOOO 

CODE 

L NEAR 

OOOO 

CODE 

L NEAR 

0079 

CODE 

Number 

0008 


Number 

0004 


Number 

OOOO 


Number 

OOOO 


Number 

OOO 1 


Number 

0002 


Number 

0002 


Number 

0004 


Number 

0003 


Number 

0006 


Number 

0007 


Number 

OOOE 


L NEAR 

OOOO 

CODE 

L NEAR 

OOOO 

CODE 

L NEAR 

OOOO 

CODE 

Number 

0114 


Number 

0294 


L NEAR 

OOOO 

CODE 

L NEAR 

OOOO 

CODE 

L NEAR 

OOOO 

CODE 


Externa 1 


External 
Ext er na 1 
External 


Ext er na 1 
Ext er na 1 
G 1 oba 1 


Externa 1 
Ext er na 1 
Ext er na 1 
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HWRITE L NEAR OOOO CODE External 

HWRITEV L NEAR OOOO CODE External 

IDBIT Number OOEO 

IDBITV Number OOAO 

lONF Number OOlO 

INTHDL L NEAR OOOO CODE External 

tF Number OOOA 

LINDEX Number 0002 

LSTEPP Number 0004 

MSCTF Number 0004 

MSDOS Number 0002 

NCYLD__OFF Number 0040 

NT__AST__0FF Number 0020 

NUMHEAD Number 0004 

0SN__0FF Number 001C 

PARTITION V WORD OOOO CODE External 

PART^FTN Number OOOO 

PART__LTN Number 0002 

PART__PAS Number 0004 

PASE_0FF Number 0005 

PAS__ASN Number 0004 

PAS__ATN Number OOOS 

PAS__BSN Number 0002 

PAS__BTN Number OOOO 

PRE__READ Alias FALSE 

RDBASE Number 0060 

RDCMD Number 0067 

RDCMD2 Number 0068 

RDINTF Number 0008 

RDREAD Number 0020 

RDSTAT Number 0067 

RDWRITE Number 0030 

RDXLT V BYTE OOOO CODE External 

RESTOR Number 0010 

SBUFR Number 0001 

SCANID Number 0040 

SCTEXT Number 0080 

SDH Number 0066 

SECPTRK Number 0010 

SECSI2E Number 0200 

SECTC Number 0062 

SECTN Number 0063 

SECTSZ Number 0060 

seek Number 0070 

SEEKC Number O0 1 0 

SEEKC2 Number OO 1 O 

SERR Number OOOF 

SINIT Number 0002 

SSCTF Number OOOO 

SSZ128 Number 0060 

SSZIK Number 0040 

SSZ256 Number OOOO 

SSZ512 Number 0020 

STEPRO Number OOOO 

STEPRl Number OO0 1 
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STEPR2 . . 

STEPR3 . . 

STEPR4 . . 

STEPR5 . . 

STEPR6 . . 

STEPR7 . . 

STEPR8 . . 

STEPR9 
STEPRA . . 

STEPRB . . 

STEPRC . . 

STEPRD . . 

STEPRE . . 

STBPRF . . 

STEPR OFF. 

ST as7_off 

TEMP PTR . 
TRK02. . . 

TRKOE. . . 

TRUE . . . 

WO I SKI . . 

WDISK10. . 
WDISK2 . . 

WDISK3 . . 

WGATE. . . 

WINI_OFFSET 
WINI_SEG . 
WPC OFF. . 
WPRCMP . . 

WPRSNT . . 

WTVERR . . 

W DISK . . 

W“0ISKF. . 
XBB_BO . . 

XBB_BS . . 

XBB_CN . . 

XBB DISKF. 
XBB^DSN. . 

xbb'errc . 

XBB_L.DN . 
XBB SC . . 

xbb'sn . . 

XBDSK1 . . 

XB_FLOPPY . 
XCPRSNT. . 
XLT F . . . 


Number 

0002 


Number 

0003 


Number 

0004 


Number 

0005 


Number 

0006 


Number 

0007 


Number 

0008 


Number 

0009 


Number 

OOOA 


Number 

OOOB 


Number 

OOOC 


Number 

OOOD 


Number 

OOOE 


Number 

OOOF 


Number 

004C 


Number 

002B 


L DWORD 

0095 

CODE 

Number 

0080 


Number 

0002 


Number 

- OO0 1 


L NEAR 

0034 

CODE 

L NEAR 

0060 

CODE 

L NEAR 

004C 

CODE 

L NEAR 

0048 

CODE 

Number 

00 10 


Number 

0094 


Number 

0096 


Number 

004A 


Number 

006 1 


Number 

OOO 1 


Number 

OOOD 


L NEAR 

OO 1 C 

CODE 

L WORD 

006D 

CODE 

Number 

0008 


Number 

OOOA 


Number 

0004 


Number 

OOOO 


Number 

0003 


Number 

OOOC 


Number 

OOO 1 


Number 

0006 


Number 

0002 


L NEAR 

OO 1 0 

CODE 

L NEAR 

OO 1 8 

CODE 

Number 

0002 


V BYTE 

OOOO 

CODE 


Warning Severe 
Errors Errors 
o o 
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Symbol Cross Reference (# is definition) Cref*1 

ABRTC . 

AST OFF 
ATRETRY 


26# 

26# 

26# 


BADBD 26# 

BAT OFF 26# 

BId“aST 26# 

BID BAT 26# 

BID~BOT 26# 

BID OPD 26# 

BIO^HOM 26# 

BIO'^OSN 26# 

BID^PAS 26# 

BId”"PBT 26# 

BID^UKH 26# 

BITO 26# 

BITl 26# 

BIT1B 26# 

BIT2 26# 

BIT3 26# 

B1T4 26# 

BITS 26# 

BIT6 26# 

BIT? 26# 

BK EC OFF 26# 

BK“lBN off 26# 

BK“mBC“OFF 26# 

BOOT^OFF 26# 

CBSY 26# 

CBSY2 26# 

CGROUP 13 15 15 15 15 

CLRIL 26# 

CLRSPL 26# 

CLTPN 21# 104 

CMOIP 26# 

CODE 13 14# 14 176 

CPM8660 26# 

CR 26# 

CRCER 26# 

CTRL 0 26# 

CTRL~S 26# 

CTRL 2 26# 

CYLDH" 26# 

CYLDL 26# 


DAMNF 26# 

DATA 26# 

DATARO 26# 

DISKDF 26# 58 122 

DO XLT 101 131# 

DPDE FLAG 26# 

DPDE-FTM 26# 

DPDE“iNIT 26# 

DPDE LTN 26# 

0P0E“lU 26# 

0PDE“"0FF 26# 
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Symbol Cross Raference 


(# is definition) Cref-2 


DPDE_OST 26# 

DPDE_PN 26# 

DPDE_PON 26# 

DPD__OFF 26# 

OPD__START_OFF 26# 

DRDY . . T 26# 

DRDY2 26# 

DRIVEO 26# 

DRIVE1 26# 

0RIVE2 26# 

DRIVES 26# 

DRIVEDF 26# 

DRIVEN 26# 

DRVSEL 26# 

DSK__INIT 19# 

DSTATO 26# 

DSTATI 26# 

DWRTF 26# 

DWRTF2 26# 


ERRF 26# 

ERROR 26# 


false 26# 26 

FMTTRK 26# 


GETFTN 

CETFTNO 

GETPEA 

GET_REG 


2 1# 

2 1# 95 

2 1# 

39 163# 


HOIR . . . 
HDISK. . . 
HEAD©. . . 
HEAD02 . . 
HEAD 1 . . . 
HEAD12 . . 
HEAD2. . . 
HEA022 . . 
HEADS. . . 
HEA032 . . 
HEADM. . . 
HEA0M2 . . 
HFORMAT. . 
HINIT . . . 
HIOCTL . . 
HIVEC_A. . 
HIVEC_B. . 
HMCHK. . . 
HREAD. . . 
HVDISK . . 
HV^RITE . . 
HWRITEV. . 


26# 
26# 
26# 
26# 
26# 
26# 
26# 
26# 
26# 
26# 
26# 
26# 
1 8# 
1 8 # 
24 
26# 
26# 
1 8# 
1 7# 
1 9# 
1 7# 
1 7# 


5 1 


1 4 1 
37# 


142 
1 38 

143 
1 39 
1 40 


IDBIT 26# 

IDBITV 26# 

IDNF 26# 
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Symbol Cross Reference 

INTHDL 

LF 

LINDEX 

LSTEPP 


(# is definiti on ) 

19 # 

26# 

26# 

26# 


Cref -3 


MSCTF 26# 

MSDOS 26# 


NCYLD OFF 26# 

NT_AST__OFF 26# 

NUMHEAO 26# 


OSN_OFF 26# 

PARTITION 22# 

PART_FTN 26# 

PART LTN 26# 

PART”pAS 26# 

PASE_OFF 26# 

PAS_ASN 26# 

PAS_ATN 26# 

PAS_BSN 26# 

PAS BTN 26# 

PRE^REAO 26# 

RDBASE 26# 26 26 26 26 26 26 26 26 26 26 26 26 26 

RDCMO 26# 

RDCMD2 26# 

RDINTF 26# 

ROREAD 26# 

ROSTAT 26# 

RDWRITE 26# 

RDXLT 20# 134 

RESTOR 26# 


SBUFR 26# 

SCANID 26# 

SCTEXT 26# 

SOH 26# 

SECPTRK 26# 

SECSI2E 26# 

SECTC. 26# 

SECTN 26# 

SECTS! 26# 

SEEK 26# 

SEEKC 26# 

SEEKC2 26# 

SERR 26# 

SINIT 26# 

SSCTF 26# 

SS2128 28# 

SS21K 26# 

SS2256 26# 

SS2S12 26# 

STEPRO 26# 

ST1PR1 26# 
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Symbol Cross Raferonco 


(# is definition) Cref-4 


STEFR2 26# 

STEPR3 26# 

STEPR4 26# 

STEPR5 26# 

STEPR6 26# 

STEPR7 26# 

STEPR8 26# 

STEPR9 26# 

STEPRA 26# 

STEPR6 26# 

STEPRC 26# 

STEPRD 28# 

STEPRE 26# 

STEPRF 26# 

STEPR OFF 26# 

ST_AST_OFF 26# 

TEMP PTR 1 1 6 1 64 1 65 1 74# 

TRK02 26# 

TRKOE 26# 

TRUE 26# 26 

WOISKl 91 93# 

WDISK10 97 120# 

W0ISK2 83 1 10# 

W0ISK3 100 102# 

WGATE 26# 

WlNl OFFSET 26# 

WINI-SEG 26# 

WPC OFF 26# 

WPRCMP 26# 

WPRSNT 26# 

WTVERR 26# 

W_DISK 47 53 80# 

W_DISKF 115 138# 

XBB_BO 26# 171 

XBB_BS 26# 

XBB_CN 26# 169 

XBB__DISKF 26# 167 

XBb”dSN 26# 

XBB*~ERRC 26# 117 

XBB“lDN 26# 

XBB_SC ... 26# 170 

XBB_SN 26# 1 68 

XB0SK1 41 51# 

XB_FLOPPY 46 52 57# 

XCPRSNT 26# 

XLT__F 20# 8 1 92 99 
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2 




TITLE 

Hard Disk Driver 

3 




NAME 

HOD 


5 




08/30/83 


7 



CGROUP 

GROUP 

CODE 


8 

oooo 


CODE 

SEGMENT 

BYTE PUBLIC 'CODE' 

9 



ASSUME 

CSiCGROUP, DStCGROUP, ESiCGROUP, SS;CGROUP 

10 







1 1 




EXTRN 

RDXLT : BYTE 

1 2 







1 3 




PUBL I C 

HREAD 

- r ead sect or ( s ) 

1 4 




PUBL I C 

HWRI TE 

- write sect or { s ) 

15 




PUBLIC 

HWR I TEV 

- write sector(s) with verify 

1 6 




PUBLIC 

HFORMAT 

- format t r ac k ( s ) 

1 7 




PUBL I C 

H 1 N I T 

- init hard disk drive 

18 




PUBL I C 

HMCHK 

- media check 

19 




PUBL I C 

HVDISK 

- verify disk 

20 




PUBL I C 

I NTHDL 

- hard disk interrupt handler 

2 1 




PUBL I C 

XLT F, CLTPN, MAXTRK . STEPRATE . PRECOMP 

22 







23 




.LIST 



24 







25 

oooo 

0098 

MAXTRK 


DW 152 ; max track # 

26 

0002 

06 

STEPRATE 

DB STEPR6 ; Step rate value 

27 

0003 

0020 

PRECOMP 


DW 

28/4 ; write pre-comp value 

28 







29 

0005 

OO 

RETNS 

OB 

0 

; # of sectors do retry 

30 

0006 

00 

RETRIES 

OB 

0 

: retry count 

3 1 







32 

0007 

OOOO 

ERRCODE 

OW 

0 

error code save area 

33 

0009 

OO 

WRTWVF 

OB 

0 

write with verify flag 

34 







35 

OOOA 

OO 

XLT_F 

OB 

0 

translate table flag 


36 

37 ENDIF 
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38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
6 1 
62 

63 

64 

65 

66 

67 

68 

69 

70 
7 1 

72 

73 

74 

75 

76 

77 


PACE 

Hard Disk routines are; 


1 . HREAD - 

2. HWRITE 

3 . HWR I T E V 

4. HFORMAT 
5 . HINIT - 

6. HMCHK - 

7. HVOISK 

8. INTHDL 


read sector(s) 
write sect or { s ) 

- write sector(s) with verify 

- format track(s) 
init hard disk drive 
media check 

verify d i sk 

hard disk interrupt handler 


Other support routines are: 


1 . RETRY - 

2. HOMET - 

3. MOVEMX 

4. MOVEH - 

5. LOTSKF 

6. OUTCMD 

7. ADVTNS 

8. ADVTNT 

9. DELAY - 


error recovery after a read 
restore head 

- move head to max. track 
move head 

- load hard disk task file 

- output command and wait for command completion 

- advance to next logical sector »»» this is OS dependent 

- advance to next logical track 
de 1 ay O . 5 ms 


Default values for all the variables are set for the RD51/RD50 
Winchester drive. They are: 


SECPTRK s 16 
SECSIZE : 512 

NUMHEAO : 4 

( RDXLT ) s 


sector per track 
sect or size 

number of surfaces per cylinder 
CP/M skew table with skew factor 7 
this is the only item here that OS 
dependent 


Values has to be loaded for different drive: 


RD51 RD50 

MAXTRK : 305 152 ; max. cylinder number 

STEPRATE : O 6 ; Step rate value 


78 


PRECOMP = 200/4 = 50 128/4 


write precorop value 
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79 




PAGE 



80 




; ************ 

********************* 


8 1 







82 




i HREAD 

- HARD DISK READ SECTOR 

83 







84 




! ENTRY 



85 





BH s surface/drive 

# 

86 





BITO-3surface# 

87 





B I T 4 - 7 dr i ve # 

88 





BL ~ sector 0 


89 





CX : sector # 


90 





OX = cylinder # 


9 1 





ES:DI : buffer start address 

92 




! EXIT : 



93 





Z flag is set if error 

94 





AX : ERROR STATUS 


95 





AL : 0, NO 

ERROR 

96 





: 1 . ERROR 

97 





: 3. DRIVE DEFFECTIVE 

98 





= 5. DISK DEFFECTIVE 

99 





= ODH , 

WRITE VERIFY ERROR 

100 





s OFH , 

SOFT ERROR 

101 





AH. BIT O 

: DAM NOT FOUND 

102 





BIT 1 

s TRACK 0 ERROR 

103 





BIT 2 

: ABORTED COMMAND 

104 





BIT 4 

: ID NOT FOUND 

105 





BIT 6 

: CRC ERROR DATA FIELD 

106 





BIT 7 

s BAD BLOCK DETECT 

107 





(RETNS) : NUMBER OF SECTORS PERFORMED THE RETRY 

108 







109 




; «»««»»««»«*« 


**«»«*****»«»»*»»»*»»«#«»*»»»»» 

1 10 







1 1 1 

OOOB 



HREAD : 



1 12 

OOOB 

FC 


CLD 


set forward flag 

1 13 

OOOC 

C6 

06 0005 R OO MOV 

BYTE PTR RETNS. O 

no any sector do retry yet 

1 1 4 







1 15 




END IF 



1 1 6 







1 1 7 







1 18 




r ead 

sector(s) loop 


1 19 







1 20 

001 1 



HREA05 : 



121 

001 1 

E8 

0105 

R CALL 

LDTSKF 

1 oad task file 

1 22 

0014 

76 

37 

JNZ 

HREAD2 

; error if pass limit 

123 

0016 

BO 

20 

MOV 

AL . ROREAD+ATRETRY 

output read command 

124 

0018 

E8 

014F 

R CALL 

OUTCMD 


1 25 

00 IB 



HREAD10 : 



126 

00 IB 

OA 

CO 

OR 

AL . AL 

; error? 

1 27 

00 ID 

74 

07 

JZ 

HREAD3 

Skip if no error 

1 28 

00 IF 

E8 

01FO 

R CALL 

RETRY 

; error recovery 

1 29 

0022 

OA 

CO 

OR 

AL . AL 

; still have error? 

130 

0024 

75 

27 

JNZ 

HREA02 

abort at this point 

131 

0026 



HREAD3 : 



132 

0026 

52 


PUSH 

OX 

; save cy 1 i nder # 

133 

0027 

51 


PUSH 

CX 

; save sector count 
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1 34 

0028 

BA 

0060 

MOV 

DX, OFFSET DATA 

get data port addr 

1 35 

0O2B 

B9 

O 100 

MOV 

CX .SECS I ZE/2 

get sector size in words 

1 36 

002E 



HREAO 1 ; 


es:di has buffer addr 

1 37 

002E 

EC 


I N 

AL . DX 

(8) get data byte 

1 36 

002F 

BA 

EO 

MOV 

AH . AL 

(2) save to high byte 

1 39 

003 1 

EC 


I N 

AL . DX 

(8) get next byte 

1 40 

0032 

86 

C4 

XCHC 

AL . AH 

(4) make into correct order 

141 

0034 

A8 


STOSW 


(IS) save into buffer 

142 

0035 

E2 

F7 

LOOP 

HREAD 1 

( 17) loop for whole sector 

143 






144 

0037 

59 


POP 

CX 

restore sector count 

145 

0038 

5A 


POP 

DX 

restore cylinder # 

146 






1 47 

0039 

BO 

O 1 

MOV 

AL . SBUFR 

strobe buffer ready 

144 

003B 

E6 

68 

OUT 

RDCMD2 , AL 

1 49 







1 50 

0030 

E8 

O 1 8F R 

CALL 

ADVTNS 

; advance to next sector 

1 5 1 

0040 

E2 

CF 

LOOP 

HREAD5 

loop for multi-sector 

152 







1 53 




ENDIF 



1 54 







155 

0042 

33 

CO 

XOR 

AX. AX 

assume no error 

156 

0044 

F6 

06 0005 R FF 

TEST 

BYTE PTR RETNS.OFFH 

retry before? 

157 

0049 

74 

02 

JZ 

HREAD2 

158 

0O4B 

BO 

OF 

MOV 

AL.SERR 

set soft error 

159 

0040 



HREAD2 ; 



1 60 




I F NOT 

PRE READ 


1 6 1 

0040 

EB 

62 90 

JMP 

led“off 

this is the way to handle LED 

1 62 




END I F 


i f no pr O— r ead 

1 63 







164 

0050 

C3 


RET 




The Microsoft MACRO Assembler 02-20-44 PACE 1-5 

Hard Disk Dr i ver 


1 65 


1 66 


1 67 


1 68 


1 69 


1 70 


1 7 1 


1 72 


1 73 


1 74 


1 75 


176 


1 77 


1 78 


1 79 


1 80 


181 


182 


1 83 


1 84 


185 


186 


187 


1 88 


189 


1 90 


1 9 1 


192 


193 


194 


195 


196 


197 

005 1 

196 

005 1 

199 

0056 

200 


201 

0058 

202 

0058 

203 

OOSD 

204 

OOSD 

205 


206 


207 


208 

0O5E 

209 


2 10 


21 1 


212 

0060 

213 

0060 

2 1 4 

0063 

215 

0065 

216 

0067 

217 

006A 

218 

006C 

219 



C6 06 0009 R 01 
EB 05 


C6 06 0009 R OO 
PC 


»B F7 


E8 0105 R 
75 4C 
BO 30 
E8 014F R 
OA CO 
75 43 


PACE 


HWRITE - hard disk write sector (without verify) 
HWRITEV - write sector with verify 


ENTRY : 


EXIT: 


BH - surface/drive number 
BIT 0-3 surface # 

BIT 4-7 drive # 

BL = sector # 

CX s sector count 

OX t cy 1 i nder P 

ES:DI s buffer start address 


Z flag is set i f 
AX * ERROR STATUS 
AL 


»r r or 


> O. NO ERROR 
= 1 , ERROR 

t 3. DRIVE DEFFECTIVE 
* 5, DISK DEFFECTIVE 
: OOH. VYRITE VERIFY ERROR 
B OFH. SOFT ERROR 
. BIT O > DAM NOT FOUNO 
BIT 1 t TRACK O ERROR 
BIT 2 t ABORTED COMMAND 
BIT 4 s ID NOT FOUNO 
BIT 6 t CRC ERROR DATA FIEID 
BIT 7 s BAD BLOCK DETECT 




HWRITEV : 

MOV BYTE PTR WRTWVF , 1 

JMP SHORT HWRITE1 

HWRITE : 

MOV BYTE PTR WRTWVF. O 

HWRITEl : 

CLD 

ENDIF 

MOV SI.DI 

; write sector loop 

MWRITE5 : 

CALL LDTSKF 

JNZ HWRITE2 

MOV AL . RDWRITEPATRETRY 

CALL OUTCMD 

OR AL.AL 

JNZ HWRITE2 


; SET WRITE WITH VERIFY FLAG 

; CLEAR WRITE WITH VERIFY FLAG 
; SET FORWARD FLAG 

; SI s BUFFER ADDR 

; LOAD TASK FILE 

error if pass limit 
; OUTPUT WRITE CMO 

; ERROR? 

; ABORT IF ERROR 
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220 

006E 

52 


PUSH 

OX 

; SAVE cylinder # 

22 1 

006F 

5 1 


PUSH 

CX 

; SAVE SECTOR COUNT 

222 

0070 

BA 

0060 

MOV 

OX, OFFSET DATA 

: GET DATA PORT ADDR 

223 

0073 

B9 

otoo 

MOV 

CX . SECS I ZE/2 

: GET SECTOR SIZE in words 

224 

0076 

1 E 


PUSH 

DS 

: SAVE DS 

225 

0077 

06 


PUSH 

ES 

; DSsES 

226 

0078 

1 F 


POP 

DS 


227 

0079 



HWR1TE21 : 


: DS:SI HAS BUFFER ADDR 

228 

0079 

AD 


LODSW 


; (16) GET DATA FROM BUFFER 

229 

O07A 

EE 


OUT 

OX . AL 

; (8) OUTPUT DATA TO RD 

230 

007B 

8A 

C4 

MOV 

AL , AH 

; (2) GET HIGH BYTE 

23 1 

007D 

EE 


OUT 

OX , AL 

; (8) 

232 

007E 

E2 

F9 

LOOP 

HWR I TE2 1 

; (17) LOOP FOR WHOLE SECTOR 

233 







234 

0080 

IF 


POP 

DS 

; GET DS BACK 

235 

008 1 

59 


POP 

CX 

; RESTORE SECTOR COUNT 

236 

0082 

5A 


POP 

OX 

; RESTORE cylinder # 

237 







238 

0083 

2E 

C6 06 01E7 R OO 

MOV 

BYTE PTR CS:IR0DRQ,O 

; CLEAR INT FLAG 

239 

0089 

BO 

oi 

MOV 

AL , SBUFR 

; STROBE BUFFER READY 

240 

008B 

E6 

68 

OUT 

RDCMD2 , AL 


24 1 

008D 

E8 

0157 R 

CALL 

OUTCMD 1 

; WAIT UNTIL RD GETS IT 

242 

0090 

OA 

CO 

OR 

AL , AL 

; ERROR? 

243 

0092 

75 

1 D 

JNZ 

HWRI TE2 

; ABORT IF ERROR 

244 







245 




check 

for write with verify 


246 







247 

0094 

F6 

06 0009 R FF 

TEST 

BYTE PTR WRTWVF,OFFH 


248 

0099 

74 

OF 

J2 

HWRITE 1 1 

; NO VERIFY 

249 







250 

009B 

BO 

20 

MOV 

AL , RDREAD+ATRETRY 

; OUTPUT READ COMMAND 

25 1 

009D 

E8 

O 1 4F R 

CALL 

OUTCMD 

; TASK FILE SHOULD CONTAIN THE SAME 

252 






; cy 1 i nder/sur face/SECTOR INFORMATION 

253 

OOAO 

OA 

CO 

OR 

AL , AL 

; ERROR? 

254 

OOA2 

BO 

OD 

MOV 

AL ,WTVERR 

; ASSUME WRITE VERIFY ERROR 

255 

OOA4 

75 

OB 

JNZ 

HWRl TE2 

SKIP IF NO ERROR 

256 







257 

OOA6 

BO 

O 1 

MOV 

AL , SBUFR 

; STROBE BUFFER READY 

258 

OOA8 

E6 

68 

OUT 

RDCMD2 . AL 


259 

OOAA 



HV^RI TE 1 1 : 



260 

OOAA 

E8 

O 1 8F R 

CALL 

ADVTNS 

; ADVANCE TO NEXT SECTOR 

26 1 

OOAD 

E2 

B 1 

LOOP 

HWRl TE5 

; LOOP FOR MU L T I _S E C T 0 R 

262 







263 

OOAF 

33 

CO 

XOR 

AX , AX 

; SET NO ERROR STATUS 

264 

OOB 1 



HWRl TE2 : 



265 




; CALL 

LED_OFF 

; w i n i b 1 i nk 

266 




; RET 



267 







268 







269 

OOB 1 



LED_OFF : 



270 

OOB 1 

50 


PUSH 

AX 

; save 

27 1 

OOB2 

BO 

38 

MOV 

AL , SSZ5 1 2 + DRI VE3 

; de- se 1 ect drive 

272 

OOB4 

E6 

66 

OUT 

SDH . AL 


273 

OOB6 

58 


POP 

AX 


274 

00B7 

C3 


RET 
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7H*1fti************************ 


277 







278 




; HFORMAT - HARD DISK TRACK FORMAT 

ROUTINE 

279 







280 




• ENTRY 



28 1 





BH : DRI VE/sur f ace NUMBER 


282 





D X s cy 1 i nder # 


283 





CX : TRACK COUNT 


284 





ESrOI = FORMAT BUFFER 


285 







286 




; This 

format routine is used to format (CX) tracks. 

287 




; ES : DI 

holds additional parameter 

i nf or mat i on . 

288 




; Each 

sector requires a 2 bytes sequence. The first 

289 




; byt e 

designates whether a bad bloock mark is to be 

290 




; recorded in the sector's ID fieic 

A ' OO ' H is norma 1 ; 

29 1 




: a '80 

'H indicates a bad block mark for that sector. 

292 




; The second byte indicates the logical sector number 

293 




: t o be 

r ecor dad . 


294 




; ES : DI 

expecting total number of Ic 

>yt es : 

295 







296 




; 2 * 16 » (number of track to be 

ormat t ed ) 

297 







298 




• EXIT: 



299 





Z flag is sot if error 


300 







301 




; »*»»»»»»««»» 


302 







303 

OOB8 



HFORMAT ; 



304 

00B8 

FC 


CLO 


SET FORWARD FLAG 

305 







306 




ENDIF 



307 







308 

OOB9 

8B 

F7 

MOV 

SI , 01 

GET BUFFER ADDR 

309 







310 




: format track loop 


3 1 1 







312 

OOBB 



HF0RMAT5 : 



313 

OOBB 

B3 

28 

MOV 

BL , 40 

# of bytes for gaps 

3 1 4 

OOBD 

E8 

0105 

R CALL 

LDTSKF 

LOAD TASK FILE 

315 

OOCO 

75 

3A 

JNZ 

HF0RMAT2 

error if pass limit 

316 

OOC2 

BO 

10 

MOV 

AL , SECPTRK 

SET # OF SECTORS PER TRACK 

317 

OOC4 

E6 

62 

OUT 

SECTC . AL 


318 







319 

OOC6 

BO 

SO 

MOV 

AL . FMTTRK 

OUTPUT WRITE CMD 

320 

OOC8 

E8 

OI 4F 

R CALL 

OUTCMD 


321 

OOCB 

OA 

CO 

OR 

AL , AL 

ERROR? 

322 

OOCO 

75 

20 

JNZ 

HF0RMAT2 

ABORT IF ERROR 

323 







324 

OOCF 

52 


PUSH 

OX 

SAVE cylinder # 

325 

OODO 

51 


PUSH 

CX 

SAVE SECTOR COUNT 

326 

OOD1 

BA 

0060 

MOV 

OX, OFFSET DATA 

GET PORT ADDR 

327 

0004 

B9 

0010 

MOV 

CX , SECPTRK 

GET # OF SECTORS PER TRACK 

328 

OOD7 

IE 


PUSH 

DS 

SAVE OS 

329 

OOD8 

06 


PUSH 

ES 

DSbES 
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330 

OOD9 

1 F 



POP 

OS 


331 

OODA 




HFORMAT 1 : 


DS:SI HAS BUFFER AOOR 

332 

OODA 

AD 



LODSW 


(16) GET DATA FROM BUFFER 

333 

OODB 

EE 



OUT 

DX , AL 

(8) OUTPUT BAD BLOCK MARK 

334 

OODC 

8A 

C4 


MOV 

AL . AH 

(2) GET DATA FROM BUFFER 

335 

OODE 

EE 



OUT 

DX , AL 

(6) OUTPUT LOGICAL SECTOR # 

336 

OOOF 

E2 

F9 


LOOP 

HFORMAT 1 

(17) LOOP FOR ALL SECTOR 

337 








338 

00E1 

1 F 



POP 

OS 

GET DS BACK 

339 

OOE2 

59 



POP 

CX 

RESTORE SECTOR COUNT 

340 

OOE3 

5A 



POP 

OX 

RESTORE cylinder # 

34 1 








342 

OOE4 

2E 

C6 

06 01E7 R 00 

MOV 

BYTE PTR CS:IRODRO,0 

CLEAR INT FLAG 

343 

OOEA 

BO 

O 1 


MOV 

AL.SBUFR 

; STROBE BUFFER READY 

344 

OOEC 

E6 

68 


OUT 

RDCMD2 , AL 


345 

OOEE 

E8 

0157 

R 

CALL 

0UTCMD1 

WAIT UNTIL RD GETS IT 

346 

OOF 1 

OA 

CO 


OR 

al.al 

ERROR? 

347 

OOF3 

75 

07 


JN2 

HF0RMAT2 

ABORT IF ERROR 

348 








349 

OOF5 

E8 

01BD 

R 

CAL L 

ADVTNT 

; ADVANCE TO NEXT TRACK 

350 

OOFS 

E2 

C 1 


LOOP 

HFORMATS 

; LOOP FOR MULTI_TRACK FORMAT 

35 1 








352 

OOFA 

33 

CO 


XOR 

AX . AX 

: SET NO ERROR STATUS 

353 

OOFC 




HF0RMAT2 ; 



354 

OOFC 

EB 

B3 


JMP 

LED_OFF 

; blink and RET 
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355 

356 

357 

358 

359 

360 

36 1 

362 

363 

364 

365 

366 

367 

368 

369 

370 

37 1 

372 

373 

374 

375 

376 

377 

378 

379 
360 


OOFE 

OOFE 68 OAOO 

O 1 O 1 C3 


0102 

0102 BO 05 
0104 C3 


PAGE 

HMCHK - MEDIA CHECK 

EXIT; AL s O. NO ERROR 
AH : 10, RD51 ID 


MOV AX . OAOOH ; return with RD51 ID 

RET 


; HVOISK - VERIFY DISK 

i EXIT: AL : DISK DEFFECTIVE ERROR VALUE 

HVDISK : 

MOV AL,OISKOF ; RETURN WITH DISK 

RET ; DEFFECTIVE ERROR 
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381 




PAGE 



382 




*»«»««**»»**««**««»«*««»«« 


383 







384 




LDTSKF - 

load 'TASK 

FILE', controller registers 2-6 

385 







386 




ENTRY : 



387 





8H s drive/surface # I 

388 





8L : sector 

# ! 

389 





OX s cy 1 i nder # 

390 





(MAXTRK) = 

max track # 

39 1 




EXIT : 

AX s O and 

2 flag is sot if no error 

392 





AX : 1001H 

(ID not found error) and Z flag is cleared 

393 





i f 

track F > (MAXTRK) 

394 







395 




»«*»*»«»»»»»«*« 

»»«*»****«* 


396 







397 

0105 



LDTSKF : 



398 

0105 

88 

1001 

MOV 

AX . 1001 H 

; load error code 

399 

0108 

38 

1 6 OOOO R 

CMP 

OX . MAXTRK 

: check pass limit 

400 

010C 

77 

1 8 

JA 

LDTSKF 1 

; error if > 

401 

010E 

8A 

C2 

MOV 

AL , DL 


402 

Olio 

E6 

64 

OUT 

CYLDL . AL 

; 1 ow cy 1 i nder 

403 

0112 

8A 

C6 

MOV 

AL . OH 


404 

0114 

E6 

65 

OUT 

CYLDH , AL 

; high cy 1 i nder 

405 







406 

0116 

80 

20 

MOV 

AL . SSZS 1 2 

; get sect or size 

407 

0118 

OA 

C7 

OR 

AL . 8H 

; or with surface #, assume driveO 

408 

01 1 A 

E6 

66 

OUT 

SDN , AL 


409 







4 10 

01 1C 

8A 

C3 

MOV 

AL , 8L 

; get sector # 

4 1 1 

01 IE 

E6 

63 

OUT 

SECTN . AL 


412 







4 13 

0120 

80 

01 

MOV 

AL . 1 

; do 1 sector 

4 1 4 

0122 

E6 

62 

OUT 

SECTC , AL 


4 1 5 

O 1 24 

33 

CO 

XOR 

AX . AX 


4 1 6 

0126 


1 

LDTSKF 1 : 



4 1 7 

0 126 

23 

CO 

AND 

AX , AX 

; set Z flag 

4 18 

0128 

C3 


RET 
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420 
42 1 

422 

423 

424 

425 

426 

427 

428 

429 


HINIT - hard disk init routine 




********«»«» 


ENTRY : 
EXIT: 


Interrupt vector must be set 
AX = error status 


;«»»»»»» 

HINIT; 








430 

0129 

FC 



CLD 


: set forward direction 

43 1 

01 2A 

FB 



ST I 


;TRY IT WITH INTERRUPTS ON 

432 





END IF 



433 








434 

0128 

80 

02 


MOV 

AL .SINIT 

; set software init 

435 

0120 

E6 

68 


OUT 

R0CM02 , AL 


436 

01 2F 

E8 

01E8 

R 

CALL 

DELAY 

allow 0.5 ms 

437 








438 

0132 

A 1 

0003 

R 

MOV 

AX . PRECOMP 

; init write pre-comp value 

439 

0135 

E6 

6 1 


OUT 

WPRCMP . AL 

440 








44 1 

0137 

OC 

20 


OR 

AL , DRIVEO'i-SSZ5 12’kHEADO 

; set size/drive/surface register 

442 

0139 

E6 

66 


OUT 

SOH , AL 

443 








444 

0138 

88 

0O01 


MOV 

BX , 1 

; sector 1 

445 

01 3E 

BA 

0004 


MOV 

OX , 4 


446 

0141 

E8 

0243 

R 

CALL 

M0VE04 

; move head to track o 

447 








448 

0144 

AO 

0002 

R 

MOV 

AL , STEPRATE 

; set step-rate and 

449 

0147 

04 

10 


ADD 

AL , RESTOR 

: restore 

450 

0149 

E8 

01 4F 

R 

CALL 

OUTCMO 

; output the restore cmd 

45 1 

01 4C 

ES 

008 1 

R 

JMP 

LED OFF 

: turn off LEO and RET 
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452 

453 

454 

455 

456 

457 
455 

459 

460 
46 1 
462 


PAGE 


OUTPUT COMMAND TO WINNIE 


ENTRY : 
EXIT : 
USED : 


AL 

AX 

AX 


COMMAND 
ERROR STATUS 


463 

01 4F 



464 

01 4F 

2E : 

Cl 

465 

0155 

E6 

67 

466 

0157 



467 

0157 

53 


466 

0155 

51 


469 




470 

0159 

B3 

20 

471 

01 5B 



472 

01 5B 

B9 

60' 

473 

01 5E 



474 

01 5E 

2E : 

; F( 

475 

01 64 

75 

16 

476 

01 66 

E2 

F6 

477 

0166 

FE 

CB 

476 

01 6A 

75 

EF 

479 

Ol 6C 



450 

01 6C 

BO 

03 

45 1 

01 6E 



452 

Ol 6E 

5A 

EO 

453 

0170 

BO 

Ol 

464 

0172 

E6 

65 

455 

Ol 74 

E4 

6 1 

456 

0176 

E4 

61 

467 

0175 

E4 

61 

458 

Ol 7A 

86 

C4 

459 

Ol 7C 

EB 

OE 

490 

01 7E 



49 1 

017E 

E4 

67 

492 

Ol SO 

24 

20 

493 

0152 

75 

E8 

494 

0154 

E4 

67 

495 

0156 

24 

Ol 

496 

0158 

75 

E4 

497 

Ol 5A 

33 

CO 

496 

Ol 5C 



499 

Ol 5C 

59 


500 

Ol 6D 

5B 


501 

Ol 5E 

C3 



OUTCMD : 


MOV 

OUT 


0UTCMD1 : 

PUSH 

PUSH 

MOV 

0UTCM02 : 

MOV 

0UTCMD1 1 ; 

TEST 

JNZ 

LOOP 

DEC 

JNZ 


0UTCMD3 ; 
0UTCMD6 ; 


MOV 

MOV 

MOV 

OUT 


XCHG 

JMP 

IN 

AND 

JNZ 

IN 

AND 

JNZ 

XOR 

POP 

POP 

RET 


BYTE PTR CS:IRODRO.O 
RDCMO, AL 

BX 

CX 

BL, 4*6 
CX. 32595 

BYTE PTR CS ; IRODRO.OPPH 

0UTCMD4 

OUTCMD 1 1 

BL 

0UTCM02 

AL . DRIVEDF 

AH. AL 
AL .SBUFR 
R0CMD2 . AL 
AL . ERROR 
AL . ERROR 
AL . ERROR 
AL . AH 

SHORT 0UTCMD5 

AL . RDSTAT 
AL . DWRTF 
0UTCMD3 
AL . RDSTAT 
AL . ERRF 
0UTCMD6 
AX. AX 

CX 

BX 


t**»»««*»»**»*»»«*»*»s«* 

CONTROLLER 


»**»»«*»»**»*«»«»*«»»««* 

CLEAR INT FLAG 
OUTPUT COMMAND 

SAVE REGISTERS 

ABOUT 6 SECONDS TIME OUT 

32585»35 C L OCXS »0 . 2US * 250MS 

WAIT FOR INT, 17 CLOCKS 
JMP IF INT, 4 CLOCKS 
17 CLOCKS 

SET HARDWARE ERRDR FLAG 

SAVE MAIN ERRDR STATUS 
STROBE BUFFER READY 

READ RD ERROR STATUS 

(THIS IS NOT BUCM, WAIT UNTIL 

ERROR REGISTER IS VALID) 

FDRH ERROR STATUS 


GET STATUS 
CHECK WRITE FAULT 

GET STATUS AGAIN 
CHECK ERROR 
ERROR 
NO ERROR 

RESTORE REGISTERS 
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502 

503 

504 

505 

506 

507 
505 

509 

510 
5 1 1 

512 

513 
5 1 4 

515 

516 
5 1 7 
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»******««***«»**«******««»***»«**«»**»*«**»««»«****«**»«»******* 

ADVTNS - edvence to next sector 

ENTRY: BH < surfece # 

BL • sector # 

DX « cylinder # 

(RDXLT) = trenslete teble 
(XLT_F) B O if NOT USE trenslete teble 
<> O if USE 

USED: AX 


•** NOTE: 


1. This routine is OS dependent 

2. (XLT__^F) must be set before enter this 
routTne. (This fleg will fix the logicel 


5 1 5 





not logics! end physicel net physicel problem 

5 1 9 





Act uel 1y only 

routines HREAO. HWRITE. end 

520 





HWRITEV cells 

this rout i ne . 

521 







522 




;»»«»*«»»*««***»**»«**»«*««**»»»»»»««»*»****»»»*»«»«««**»«*»*»»«* 

523 







524 

015F 



ADVTNS : 



525 

Ol 5F 

F6 

06 OOOA R FF 

TEST 

BYTE PTR XLT F.OFFH 

check if using trenslete teble 

526 

0194 

75 

OB 

JNZ 

A0VTNS3 

yes 

527 

0196 

FE 

C3 

INC 

BL 

Just set to next sector # 

528 

0198 

80 

FB 10 

CMP 

BL .SECPTRK 

pess boundery? 

529 

Ol 9B 

7E 

2A 

JLE 

ADVT1 

no 

530 

0190 

B3 

01 

MOV 

BL . 1 

yes, reset sector # 

531 

Ol 9F 

EB 

1C 

JMP 

SHORT ADVTNT 

end updete sur f ece/cy 1 i nder # 

532 







533 

Ol A1 



ADVTNS3 : 



534 

Ol A1 

51 


PUSH 

CX 

seve registers 

535 

Ol A2 

57 


PUSH 

01 


536 

537 

01 A3 

06 


PUSH 

ES 


535 

Ol A4 

OE 


PUSH 

CS 

M 

u 

M 

Ml 

539 

01 A5 

07 


POP 

ES 


540 

Ol A6 

BF 

OOOO E 

MOV 

Dl. OFFSET RDXLT 

get trenslete teble 

541 

01 A9 

B9 

0010 

MOV 

CX. SECPTRK 

get sectors per treck 

542 

01 AC 

6A 

C3 

MOV 

AL.BL 

get sector # 

543 

544 

Ol AE 

F2/ 

AE 

REPNZ 

SCASB 

check in XLT 

545 

01B0 

5A 

ID 

MOV 

BL.BYTE PTR (DIJ 

get next sector # 

546 

01B2 

07 


POP 

ES 

restore registers 

547 

01B3 

5F 


POP 

DI 


546 

01B4 

E3 

02 

JCXZ 

ADVT2 

if not in XLT 

549 

01B6 

59 


POP 

CX 


550 

01B7 

C3 


RET 




551 

552 

553 

554 

555 


01B5 

01B5 

01B9 


59 

5A IE OOOO E 


A0VT2 : 


POP 

MOV 

JMP 


CX 

BL. RDXLT 
ADVTNT 


; get first sector # 
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567 

01BD 

PE C7 

INC 

BH 

; bump surface # 

568 

01 BF 

80 FF 04 

CMP 

BH , NUMHEAD 

; check pass limit 

569 

01 C2 

7C 03 

JL 

ADVT1 


570 

01 C4 

32 FF 

XOR 

BH . BH 

; set surface # bO 

57 1 

01 C6 

42 

INC 

DX 

bump cylinder # 

572 

01 C7 


A0VT1 : 



573 

01 C7 

C3 

RET 




BS6 

557 

558 

559 

560 
56 1 

562 

563 

564 

565 

566 


AOVTNT - advence to next track 


BH t surface # 
OX : cylinder # 
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574 

575 

576 

577 

578 

579 

580 

58 1 

582 

583 

584 

585 

586 

587 

588 

589 

590 

59 1 

592 

593 

594 

595 
59 6 

597 

598 

599 

600 
601 
602 

603 

604 

605 

606 

607 

608 
609 
6 1 O 
6 1 1 
6 1 2 
6 1 3 


01 C8 

01C8 8A FA 
01CA 80 E7 03 
01CD D1 EA 
01CF D1 EA 
01D1 C3 


01 D2 

O 1 D2 D 1 E2 
01 D4 D 1 E2 
01D6 33 CO 

01D8 8A C7 
01DA 03 DO 
01DC C3 


PAGE 






CLTPN - Convert Logical Track # to Physical 
surface/cylinder Number 


ENTRY: DX = logical track # 
EXIT: BH = surface # 

DX s cy 1 i nder # 

USE: NONE 


CLTPN : 

MOV BH,DL 

AND BH,03H 

SHR DX . 1 

SHR OX . 1 

RET 


get low track byte 

keep surface only 

get rid of surface bits 


******************* 


******** 


CPTLN - Convert Physical surface/cylinder Number 
to Logical Track Number 


ENTRY: BH 

DX 

EXIT: DX 

USE: AX 


surface # 
cy 1 i nder # 
logical track # 


CPTLN : 

SHL DX . 1 

SHL OX , 1 

XOR AX, AX 

MOV AL.BH 

ADD DX,AX 

RET 


; make room for surface # 

; get surface # 

: add surface # 
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614 
616 
616 
617 
6 1 8 
619 
820 
62 1 
622 
623 
824 

625 

626 

627 

628 

629 

630 

631 

632 

633 

634 

635 

636 

637 

638 

639 

640 

64 1 

642 

643 

644 

645 

646 

647 

648 

649 

650 

65 1 

652 

653 


01 DO 

01DD SO 

01DE 2E: FE 06 01E7 R 

01E3 E4 67 


01E5 58 

01E6 CF 


01E7 

01E7 OO 


01 E8 

O 1 E8 51 
01E9 B9 0094 
01EC E2 FE 
01EE 59 
01EF C3 
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INTHDL - INTERRUPT HANDLER 

ENTRY: NONE 

EXIT: NONE 


INTHDL : 

PUSH AX 

INC BYTE PTR CSrIRODRO . ACKOWNLEDGE INT 

IN AL.RDSTAT ; CLEAR INT 

ENDIF 


POP AX 

IRET 


IRODRO LABEL 
OB 


ENTRY : 
EXIT; 


INTERRUPT FLAG f ! > 

THIS BYTE BETTER GO WITH CODE_SEG 
SINCE. OS IS UNKNOWN WHEN INTERRUPT 


»»*«»»»»«* 


DELAY ABOUT 0.5 MS 


NONE 

NONE 






DELAY : 

PUSH 

MOV 

DELAY 1 : LOOP 

POP 
RET 


CX 

CX . 1 48 
DELAY 1 
CX 


LOOP COUNT 
17 CLOCKS * 0.2 US 
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654 

655 

656 

657 

658 

659 

660 
66 1 
662 

663 

664 

665 

666 

667 

668 

669 

670 

67 1 

672 

673 

674 

675 

676 

677 

678 

679 

680 

68 1 
682 

683 

684 

685 

686 

687 

688 

689 

690 
69 1 

692 

693 


01 FO 

01F0 A3 0007 R 
01F3 FE 06 0005 R 
01F7 BE 0006 R 
01FA C6 04 OO 
01 FO 

O1F0 6A 04 
01FF 24 03 
0201 75 10 

0203 89 2C 

0205 81 E5 OOFC 

0209 01 FO 

020B 2E: FF 96 0224 R 

0210 E8 01E8 R 


02 1 3 

0213 E8 0105 R 
0216 BO 20 
0218 E8 014F R 
021B OA CO 
0210 74 04 

021F FE 04 
0221 EB DA 
0223 

0223 C3 


PAGE 

RETRY - error recovery 

ENTRY: AX s original error status 

BX = dr 1 ve/ sur f ace/ sect or 
DX = cylinder # 

EXIT: AX = original error status 

(RETNS) updates 


MOV ERRCOOE.AX 

INC BYTE PTR RETNS 

MOV SI. OFFSET RETRIES 

MOV BYTE PTR [ S I 1 . O 

RETRY 1 : 

MOV AL.ISII 

AND AL . 0000001 1 B 

JN2 RETRY2 

MOV BP . I S I 1 

AND BP . 1 1 1 1 1 1 OOB 

SAR BP . 1 

CALL CS : MOVEHRl BP 1 

CALL DELAY 

; READ SECTOR RETRY 


CALL LDTSKF 

MOV AL , RDREAD+ATRETRY 

CALL OUTCMD 

OR AL.AL 

JZ RETRY3 

INC BYTE PTR ISI] 

JMP SHORT RETRY1 

RETRY3 : 

RET 


SAVE THE ORIGINAL ERROR 
UPDATE RETRY # 

RESET LOCAL RETRY COUNT 


GET RETRY COUNT 

TIME TO DO NEW TRICKS? (EVERY 4) 
SKIP THE TRICK IF NO 
GET THE RETRY COUNT AGAIN 
ONLY KEEP THE BITS WE WANT 
SHIFT TO WORD OFFSET 
PERFORM THE TRICK 
WAIT FOR HEAD TO SETTLE 


; RELOAD REGISTERS 
; ISSUE THE READ COMMAND 

. ERROR? 

NO ERROR. FINALLY 
. 1 MORE RETRY 

; TRY MORE 
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694 





PAGE 



695 





696 








697 





MDVEHR 

MOVE HEAD ROUTINES 


698 








899 





700 








701 

0224 



MDVEHR 

LA6EL 

WORD 


702 

0224 

0264 R 


OVf 

SAME 

FIRST ROUND STAY ON SAME Cylinder 

703 

0226 

0243 R 


DW 

M0VE04 

OUT 4 cylinder 

704 

0228 

0233 R 


DW 

M0VEI4 

IN 4 cy 1 i nder s 

705 

022A 

0258 R 


DW 

HOMET 

DO A RESTORE 

706 

022C 

0230 R 


DW 

MOVEMX 

MOVE TO INNER Cylinder 

707 

022E 

0260 R 


DW 

GIVEUP 

TIME TO GIVE UP 

708 








709 








710 




; 

MOVE TO 

>#NER cylinder 


71 1 








712 

0230 



MDVEMX : 




713 

0230 

52 



PUSH 

OX 

SAVE cylinder # 

714 

023 1 

E6 

OA 


JMP 

SHORT MVI41 

GO TO LOAD MAX cylinder # 8 HOVE HEAD 

715 








716 








717 




; 

MOVE IN 

4 cy 1 i nderS 


718 








719 

0233 



MDVEI4 : 




720 

0233 

52 



PUSH 

DX 

SAVE cylinder F 

721 

0234 

83 

C2 04 


ADD 

DX , 4 

ADD 4 cy 1 i nderS 

722 

0237 

36 

16 OOOO R 


CMP 

OX .MAXTRK 

CHECK PASS MAX cylinder # 

723 

0236 

72 

OE 


JC 

MOVEH 

IF < MAX, THEN PERFORM MOVE HEAD 

724 

023D 



MV 14 1 : 




725 

023D 

86 

16 OOOO R 


MOV 

DX . MAXTRK 

LOAD THE MAX cylinder # 

726 

024 1 

E6 

08 


JMP 

SHORT MOVEH 

PERFORM MOVE HEAD 

727 








728 








729 




; 

MOVE OUT 4 cylinders 


730 








731 

0243 



M0VED4 : 




732 

0243 

52 



PUSH 

DX 

SAVE cylinder F 

733 

0244 

83 

EA 04 


SU6 

OX . 4 

SU6 4 cylinders 

734 

0247 

79 

02 


JNS 

MOVEH 

<07 

735 

0249 

33 

D2 


XOR 

DX . DX 

JUST USE 0 

736 




; 

JMP 

MOVEH 

MERGE TO MOVE HEAD 

737 








738 








739 




; 

MOVEH - 

MOVE HEAD 


740 








74 1 

0246 



MOVEH : 




742 

0246 

E8 

0105 R 


CALL 

LDTSKF 

: LOAD REGISTERS (cylinder #) 

743 

024E 

AO 

0002 R 


MOV 

AL , STEPRATE 

: GET STEP RATE and issue seek 

744 

025 1 

04 

70 


ADD 

AL . SEEK 


745 

0253 

E8 

014F R 


CALL 

OUTCMD 


1 746 

0256 

5A 



POP 

OX 

: RESTORE OLD cylinder # 

747 

0257 

C3 



RET 



748 
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749 


750 





; 

PERFORM 

RESTORE 


751 









752 

0258 




HOMET ; 




753 

0258 

AO 

0002 

R 


MOV 

AL .STEPRATE 

; GET STEP RATE 

754 

0256 

04 

10 



ADO 

AL , RESTOR 

; ISSUE RESTORE COMMAND 

755 

025D 

E9 

014F 

R 


JMP 

OUTCMD 


756 









757 









1 758 





; 

GIVE UP 

AFTER SO MANY RETRIES 


1 759 









760 

0260 




GIVEUP : 




761 

0260 

58 




POP 

AX 

; GET RID OF RETURN ADDR 

762 

0261 

A1 

0007 

R 


MOV 

AX , ERRCOOE 

: RETURN THE ORIGINAL ERROR 

763 

0264 




SAME : 




764 

0264 

C3 




RET 



765 









766 

0265 




CODE 

ENOS 



767 






END 





The Microsoft MACRO Assembler 

02-20-84 

PAGE 

Symbols- 1 

Herd Disk Driver 





Segments end groups: 





Name 

S i ze 

align 

comb i ne 

c lass 

CGROUP 

GROUP 




CODE 

026S 

BYTE 

PUBLIC 

‘ CODE ' 

Symbo 1 s : 





Name 

Type 

Value 

At t r 


ABRTC 

Number 

0004 



AOVT 1 

L NEAR 

01C7 

CODE 


ADVT2 

L NEAR 

01B8 

CODE 


ADVTNS 

L NEAR 

018F 

CDDE 


ADVTNS3 

L NEAR 

01 A1 

CODE 


AOVTNT 

L NEAR 

01BD 

CODE 


AST OFF 

Number 

0026 



ATRETRY 

Number 

OOOO 



BADBD 

Number 

0080 



BAT OFF 

Number 

00 12 



BID AST 

Number 

0005 



BID BAT 

Number 

0002 



BID BOT 

Number 

0008 



BID DPD 

Number 

0003 



BID HOM 

Number 

0O01 



BID DSN 

Number 

0004 



BID PAS 

Number 

0006 



BID PBT 

Number 

0007 



BID UKN 

Number 

OOOO 



BITO 

Number 

0001 



BIT1 

Number 

0002 



BIT15 

Number 

8000 



BIT2 

Number 

0004 



BIT3 

Number 

0008 



BIT4 

Number 

00 10 



BITS 

Number 

0020 



BITS 

Number 

0040 



BIT? 

Number 

0080 



BK EC DFF 

Number 

0008 



BK LBN OFF 

Number 

0003 



BK MEC OFF 

Number 

0006 



BOOT OFF 

Number 

002 1 



CBSY 

Number 

0080 



CBSY2 

Number 

OO01 



CLRIL 

Number 

0004 



CLRSPL 

Number 

0008 



CLTPN 

L NEAR 

0 1 C8 

CODE 

G 1 oba 1 

CMD IP 

Number 

0002 



rPMBSBO 

Number 

OOO 1 



CPTLN 

L NEAR 

01D2 

CODE 


CR 

Number 

OOOD 



CRCER 

Number 

0040 



CTRL 0 

Number 

001 1 



CTRL S 

Number 

00 1 3 
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CTRL 2 

Number 

OO 1 A 



CYLDH 

Number 

0065 



CYLDL . 

Number 

0064 



DAMNF 

Number 

0001 



DATA 

Number 

0060 



DATARQ 

Number 

0008 



DELAY 

L NEAR 

01E8 

CODE 


DELAY1 

L NEAR 

01EC 

CODE 


DISKDF 

Number 

0005 



DPDE FLAG 

Number 

OOOO 



DPDE FTN 

Number 

OOOC 



DPDE~INIT 

Number 

OOFO 



dpde“ltn 

Number 

OOOE 



DPDE LU 

Number 

0001 



dpde”off 

Number 

0020 



DPDE DST 

Number 

OOOB 



DPDE~PN 

Number 

0002 



DPDE PON 

Number 

OOOA 



DPD OFF 

Number 

00 17 



DPD START OFF 

Number 

0020 



DRDV 

Number 

0040 



DRDY2 

Number 

0040 



DRIVEO 

Number 

OOOO 



DRIVE1 

Number 

0008 



0RIVE2 

Number 

0O10 



DRIVE3 

Number 

OO 1 8 



DRIVEDF 

Number 

0003 



DRIVEM 

Number 

OO 1 8 



DRVSEL 

Number 

0001 



DSTATO 

Number 

0068 



DSTAT1 

Number 

0069 



DWRTF 

Number 

0020 



DWRTF2 

Number 

0020 



ERRCODE 

L WORD 

0007 

CODE 


ERRF 

Number 

OO01 



ERROR 

Number 

006 1 



FALSE 

Number 

OOOO 



FMTTRK 

Number 

0050 



GIVEUP 

L NEAR 

0260 

CODE 


HDIR 

Number 

0008 



HDISK 

Number 

0004 



HEADO 

Number 

OOOO 



HEAD02 

Number 

OOOO 



HEAD 1 

Number 

OO0 1 



HEAD12 

Number 

0002 



HEAD2 

Number 

0002 



HEAD22 

Number 

0004 



HEAD3 

Number 

0003 



HEAD32 

Number 

0006 



HEADM 

Number 

0007 



HEAOM2 

Number 

OOOE 



HFORMAT 

L NEAR 

OOB8 

CODE 

Global 

HFORMAT1 

L NEAR 

OOOA 

CODE 


HF0RMAT2 

L NEAR 

OOFC 

CODE 


HF0RMAT5 

L NEAR 

OOBB 

CODE 
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HINIT 

L 

NEAR 

0129 

CODE 

Global 

HIVEC A 

Number 

0 114 



HIVEC B 

Number 

0294 



HMCHK 

L 

NEAR 

OOFE 

CODE 

Global 

HOMET 

L 

NEAR 

0258 

CODE 


HREAD 

L 

NEAR 

OOOB 

CODE 

Global 

HREAD1 

L 

NEAR 

002E 

CODE 


HREAD10 

L 

NEAR 

001B 

CODE 


HREAD2 

L 

NEAR 

0040 

CODE 


HREA03 

L 

NEAR 

0026 

CODE 


HREAD5 

L 

NEAR 

001 1 

CODE 


HVDISK 

L 

NEAR 

0102 

CODE 

Globa 1 

HWRITE 

L 

NEAR 

0058 

CODE 

Global 

HWRITE1 

L 

NEAR 

0050 

CODE 


HWRITE 11 

L 

NEAR 

OOAA 

CODE 


HWRITE2 

L 

NEAR 

OOB 1 

CODE 


HWRITE21 

L 

NEAR 

0079 

CODE 


HWRITE5 

L 

NEAR 

0060 

CODE 


HWRITEV 

L 

NEAR 

005 1 

CODE 

C 1 oba 1 

IDBIT 

Number 

OOEO 



IDBITV 

Number 

OOAO 



IDNF 

Number 

001 0 



INTHDL 

L 

NEAR 

01DD 

CODE 

C loba 1 

IRODRO 

L 

BYTE 

01E7 

CODE 


LOTSKF 

L 

NEAR 

OIOS 

CODE 


LDTSKF1 

L 

NEAR 

0126 

CODE 


LEO OFF 

L 

NEAR 

OOB1 

CODE 


LF 

Number 

OOOA 



LINDEX 

Number 

0002 



LSTEPP 

Number 

0004 



MAXTRK 

L 

WORD 

OOOO 

CODE 

C 1 oba 1 

MOVEH 

L 

NEAR 

024B 

CODE 


MOVEHR 

L 

WORD 

0224 

CODE 


M0VEI4 

L 

NEAR 

0233 

CODE 


MOVEMX 

L 

NEAR 

0230 

CODE 


M0VE04 

L 

NEAR 

0243 

CODE 


MSCTF 

Number 

0004 



MSDOS 

Number 

0002 



MVI4 1 

L 

NEAR 

0230 

CODE 


NCYLD OFF 

Number 

0040 



NT AST OFF 

Number 

0020 



NUMHEAD 

Number 

0004 



OSN OFF 

Number 

O01 C 



OUTCMD 

L 

NEAR 

O 1 4F 

CODE 


OUTCMD 1 

L 

NEAR 

O 157 

CODE 


0UTCMD1 1 

L 

NEAR 

O 1 5E 

CODE 


0UTCM02 

L 

NEAR 

O 1 5B 

CODE 


0UTCMD3 

L 

NEAR 

01 6C 

CODE 


0UTCMD4 

L 

NEAR 

017E 

CODE 


0UTCM05 

L 

NEAR 

O 1 8C 

CODE 


0UTCMD6 

L 

NEAR 

O 1 6E 

CODE 


PART FTN 

Number 

OOOO 



part“ltn 

Number 

0002 



PART~PAS 

Number 

0004 



PASE OFF 

Number 

0005 
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PAS_ASN Number 0004 

PAS_ATN Number 0003 

PAS_BSN Number 0002 

PAS_BTN Number OOOO 

PRECOMP L WORD 0003 CODE Global 

PRE_READ Alias FALSE 

ROBASE Number 0060 

RDCMD Number 0067 

RDCMD2 Number 0068 

RDINTF Number 0008 

RDREAD Number 0020 

RDSTAT Number 0067 

RDWRITE Number 0030 

V BYTE OOOO CODE External 

RESTOR Number 0010 

RETNS L BYTE 0005 CODE 

RETRIES L BYTE 0006 CODE 

retry L NEAR O1F0 CODE 

RETRYI L NEAR 01FD CODE 

RETRY2 L NEAR 0213 CODE 

RETRY3 L NEAR 0223 CODE 

SAME L NEAR 0264 CODE 

SBUFR Number 0001 

SCANID Number 0040 

SCTEXT Number 0080 

SDH Number 0066 

SECPTRK Number OO 1 0 

SECSIZE Number 0200 

SECTC Number 0062 

SECTN Number 0063 

SECTSZ Number 0060 

SEEK Number 0070 

SEEKC Number 0010 

SEEKC2 Number oolo 

SERR Number OOOF 

SINIT Number 0002 

SSCTF Number OOOO 

SS2128 Number 0060 

SSZ1K Number 0040 

SSZ256 Number OOOO 

SSZ512 Number 0020 

STEPRO Number OOOO 

STEPR1 Number 0001 

STEPR2 Number 0002 

STEPR3 Number 0003 

STEPR4 Number 0004 

STEPR5 Number 0005 

STEPR6 Number 0006 

STEPR7 Number 0007 

STEPR8 Number 0008 

STEPR9 Number 0009 

STEPRA Number OOOA 

STEPRATE L BYTE 0002 CODE Global 

STEPRB Number OOOB 

STEPRC Number OOOC 
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STIPRD . . . 

STEPRE . . . 

STEPRF . . . 

STEPR OFF. . 

st_asT off . 

TRK02.“. . . 

TRKOE. . . . 

TRUE ... 
WGATE. . . . 

WINI OFFSET. 
WINI“SEG . . 

WPC OFF . . . 

WPRCMP . . . 

WPRSHT . . . 

WRTWVF . . . 

WTVERR . . . 

XBB BO . . . 

xbb~‘bs . . . 

XBB~CN . . . 

xbb”diskf. . 
xbb'osn. . . 
xbb'^errc . . 
xbb"”ldn. . . 
xbb'^sc . . . 

XBB^SN . . . 

XCPRSNT. . . 

XLT F . . . . 


Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
L BYTE 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
L BYTE 


Warning Severe 
Errors Errors 


Hard Disk Driver 

Symbol Cross Reference 

ABRTC 

ADVT 1 

ADVT2 

ADVTNS 

ADVTNS3 

ADVTNT 

AST__OFF 

ATRETRY 



BADBD. . . 

BAT^OFF . . 

BID_AST. . 
BID_BAT. . 
BID__BOT. . 
BID__DPD. . 
BID HOM. . 

bid“osn. . 
bid”pas. . 

BID^PBT. . 

bid”ukn. . 

BITO . . . 

BIT1 . . . 

B I T 1 5 . . . 

BIT2 . . . 

BIT3 . . . 

BIT4 . . . 

BITS . . . 

BITS . . . 

BIT7 . . . 

BK EC OFF. 

bk“lbn off 
bk”mec”off 

BOOT OFF . 


CBSY . . 
CBSY2. . 
CGROUP . 
CLRI L . . 
CLRSPL . 
CLTPN. . 
CMDIP. . 
CODE . . 
CPM8680 . 
CPTLN. . 
CR . . . 
CRCER. . 
CTRL 0 . 

ctrl“s . 

CTRL_2 . 
CYLDH. . 
CYLDL. . 


23# 

23# 

21 587# 

23# 


607# 

23# 

23# 

23# 

23# 

23# 

23# 404 

23# 402 


648# 
65 1 


680 



Hard Dfsk DMvar 


Symbol Cross Roforonco 


(# Is dofinitfon) Crof-2 


OISKDF 23# 379 

OPDE FLAG 23# 

OFDE”fTN 23# 

OPDE~INIT 23# 

DFOE“lTN 23# 

DFDE“lU 23# 

DPDE"*0FF 23# 

OFDE~OST 23# 

DPDE~PN. 23# 

DPDE""pON 23# 

OPD OFF 23# 

OPD“sTART off 23# 

DRDY . . T 23# 

0RDY2 23# 

drived 23# 441 

0RIVE1 23# 

DRIVE2 23# 

DRIVE3 23# 271 

DRIVEDF 23# 490 

ORIVEM 23# 

DRVSEL 23# 

DSTATO 23# 

DSTAT1 23# 

OWRTF 23# 492 

0WRTF2 23# 

ERRCODE 32# 669 762 

ERRF 23# 49S 

ERROR 23# 495 496 497 

FALSE 23# 23 

FMTTRK 23# 319 

GIVEUP 707 760# 

HDIR 23# 

HDISK 23# 

HEADO 23# 441 

HEAD02 23# 

HEAD1 23# 

HEAD12 23# 

HEAD2 23# 

HEAD22 23# 

MEAD3 23# 

HEA032 23# 

HEADM 23# 

HEADM2 23# 

HFORMAT 16 303# 

MF0RMAT1 331# 336 

HF0RHAT2 315 322 347 353# 

HF0RMAT5 312# 350 

HINIT 17 429# 

HIVEC_A 23# 

HIVEC B 23# 

HMCHK 19 365# 

HOMET 705 752# 

HREAO 13 111# 


Hard Disk Driver 


Symbol Cross Reference 


(# is definition) Cref-3 


HREADI 136# 142 

HREA01O 125# 

HREAD2 122 130 157 159# 

HREAD3 127 131# 

HREAD5 120# 151 

HVDISK 19 379# 

HWRITE 14 201# 

HWRITE1 199 203# 

HWRITE1 1 249 259# 

HWRITE2 214 219 243 255 264# 

HWR1TE21 227# 232 

HWRITE5 212# 261 

HWRITEV 15 197# 

lOBIT 23# 

lOBITV 23# 

IDNF 23# 

INTHDL 20 624# 

IRODRO 236 342 464 474 626 636# 

LDTSKF 121 213 314 397# 695 742 

LDTSKF1 400 416# 

LED_OFF 161 269# 354 451 

LF 23# 

LINDEX 23# 

LSTEPP 23# 

MAXTRK 21 25# 399 722 725 

MOVEH 723 726 734 741# 

MOVEHR 679 701# 

M0VEI4 704 719# 

MOVEMX 706 712# 

M0VE04 446 703 731# 

MSCTF 23# 

MSDOS 23# 

MVI41 714 724# 

MCYLD OFF 23# 

NT AST OFF 23# 

NUMHEAD 23# 569 

OSN__OFF 23# 

OUTCMD 124 216 251 320 450 463# 667 745 

0UTCMD1 241 345 466# 

0UTCMD1 1 473# 476 

0UTCMD2 471# 479 

0UTCMD3 479# 493 

0UTCMD4 475 490# 

0UTCMD5 499 499# 

0UTCMD6 491# 496 


PART FTN 23# 

PART“lTN 23# 

PART”pAS 23# 

PASE“oFF 23# 

PAS_ASN 23# 

PAS^ATN 23# 


755 



Hard Disk Drivar 


Symbol Cross Refaronco 


(# is dafinition) Craf-4 


PAS BSN. 
pas“bth . 

PRECOMP . 
PRE-READ 

RDBASE . 
RDCMD. . 
R0CMO2 . 
RDINTF . 
RDREAD . 
RDSTAT . 
RDWRITE . 
RDXLT. . 
RESTOR . 
RETNS. . 
RETRIES . 
RETRY. . 
RETRY1 . 
RETRY2 . 
RETRY3 . 

SAME . . 
SBUPR. . 
SCANIO . 
SCTEXT . 
SOH. . . 
SECPTRK . 
SECSIZE . 
SECTC. . 
SECTN. . 
SECTSZ . 
SEEK . . 
SEEKC. . 
SEEKC2 . 
SERR . . 
SINIT. . 
SSCTP. . 
SSZ12A . 
SSZ1K. . 
SSZ256 . 
SSZ512 . 
STEPRO . 
STEPR1 . 
STEPR2 . 
STEPR3 . 
STEPR4 . 
STEPRS . 
STEPR6 . 
STEPR7 . 
STEPRS . 
STEPRS . 
STEPRA . 
STEPRATE 
STEPRB . 
STEPRC . 
STEPRO . 
STEPRE . 


23# 

23# 



21 

27# 

436 

23# 

37 

1 IS 

23# 

23 

23 

23# 

465 


23# 

23# 

146 

240 

23# 

1 23 

2S0 

23# 

49 1 

494 

23# 

215 


1 1# 

540 

553 

23# 

449 

754 

29# 

1 13 

156 

30# 

670 


1 26 

667# 


672# 

69 1 


675 

664# 


669 

692# 


702 

763# 


23# 

23# 

23# 

147 

239 

23# 

272 

406 

23# 

3 1 6 

327 

23# 

1 35 

223 

23# 

317 

4 14 

23# 

23# 

4 1 1 


23# 

23# 

23# 

744 


23# 

156 


23# 

23# 

23# 

23# 

23# 

434 


23# 

23# 

23# 

23# 

23# 

23# 

23# 

27 1 

406 

23# 

23# 

23# 

23# 

23# 

26 


2 1 
23# 

26# 

446 


23P 

23# 

23# 


153 

1 60 

206 

23 

23 

23 

256 

344 

435 

666 



627 




669 

257 343 463 

442 

526 541 


44 1 


743 753 


306 

23 

464 


432 

23 


629 

23 


23 23 23 


Hard Disk Dr i var 


Symbol Cross Rafaranca (# is dafinition) Cref-5 

STEPRF 23# 

STEPR OFF 23# 

ST_AST_OFF 23# 

TRK02 23# 

TRKOE 23# 

TRUE 23# 23 


WCATE 23# 

WINI OFFSET 23# 

WINl“SEC 23# 

WPC OFF 23# 

WPRCMP 23# 439 

WPRSNT 23# 

WRTWVF 33# 196 202 147 

WTVERR 23# 254 

XBB BO 23# 

XBB^BS 23# 

XBB CN 23# 

XBB DISKF 23# 

XBB“dSN 23# 

XBB_ERRC 23# 

XBB LON 23# 

XBB“sC 23# 

XBB”sN 23# 

XCPRSNT 23# 

XLT_F 21 35# 525 


23 23 
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PAGE 


1 • 1 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
1 1 
1 2 

1 3 OOOO 

1 4 
1 5 
1 6 
1 7 
1 8 

1 9 
20 

2 1 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 : 0004 

32 


PAGE 60.132 

TITLE Hard Disk Initialization 
NAME HINIT 

COMPANY CONFIDENTIAL 

Copyright (C) 1983 Digital Equipment Corporation 

All rights reserved. 


; 09/22/83 

CCROUP GROUP CODE 

CODE SEGMENT BYTE PUBLIC 'CODE' 

ASSUME CS:CGROUP. DS:CGROUP. ES ; CGROUP , SS:CGROUP 

EXTRN HREADrNEAR. HWRITE:NEAR. HWRITEV:NEAR 
EXTRN HFORMAT : NEAR . HINIT:NEAR. HMCHK:NEAR 
EXTRN HVDISK:NEAR, INTHDL:NEAR, PSTRrNEAR 
EXTRN INI TAB:WORD, PTRSAVE ; DWORD , HDSKO:BYTE 
EXTRN PARTITION :WORD 

EXTRN GETFTN:NEAR. GETPEA:NEAR. CLTPN:NEAR 

EXTRN XLT_F:BYTE, MAXTRKrWORD, S TEPRATE : BYTE . PRECOMP;WORD 
EXTRN BUFFER:WORD. PART SI2E;ABS 
EXTRN XOPTION.BYTE ” 

PUBLIC DSK__INIT, RHOME, NDRV . HNFMT 
PUBLIC UP_BAT. TEMP_TRK, TEMP_SEC, HD__INIT 

.LIST 


MNPARTS EOU 


4 
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33 

34 

35 

36 

37 

38 

39 

40 

4 1 

42 

43 

44 

45 

46 

47 

48 

49 
BO 

5 1 


0000 77 

0001 77 

0002 77 

0003 7777 

0005 08 [ 


OOOO 77 
OOOE 77777777 
0012 7777 

0014 7777 

0016 


PAGE 

;Define offsets for io data packet 


lODAT STRUC 
CMOLEN DB 
UNIT DB 

CMD OB 

STATUSW DW 
DB 


8 DUP (7) 


LENGTH OF THIS COMMAND 
SUB UNIT SPECIFIER 
COMMAND CODE 
STATUS 


MEDIA DB 7 

TRANS DD 7 

COUNT DW 7 

START DW 7 

lODAT ENDS 


MEDIA DESCRIPTOR 

TRANSFER ADDRESS 

COUNT OF BLOCKS OR CHARACTERS 

FIRST BLOCK TO TRANSFER 


SUBTTL 


Common Drive parameter block definitions 



02-20-84 


PAGE 


1 -3 
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Common Drive parameter block definitions 


52 PAGE 

53 OBP STRUC 

54 

55 ; Start of Drive Parameter Block. 

56 

57 OOOO ?7?7 SECS2 DW ? ;Sector size in bytes. (dpb) 

56 0002 77 ALLOC DB 7 ; Number of sectors per alloc, block. (dpb) 

59 0003 7777 RESSEC OW 7 ;Reserved sectors. (dpb) 

60 0005 77 FATS OB 7 ; Number of FAT's. (dpb) 

61 0006 7777 MAXDIR DW 7 ; Number of root directory entries. (dpb) 

62 0008 7777 SECTORS DW 7 ; Number of sectors per diskette. (dpb) 

63 OOOA 77 MEDIAID DB 7 ; Med i a byte ID. (dpb) 

64 OOOB 7777 FATSEC DW 7 .Number of FAT Sectors. (dpb) 

65 

66 End of Drive Parameter Block. 

67 

66 OOOD 7777 SECTRK DW 7 ; Number of Sectors per track. 

69 OOOF 7777 HEADS DW 7 ; Number of heads per cylinder. 

70 0011 7777 HIDDEN DW 7 .Number of hidden sectors. 

7 1 

72 0013 OBP ENDS 

73 

74 : 0013 DPB OFF ECU 19 .Size of DPB 

75 ” 


76 SUBTTL Hard Disk Drive i n i t a 1 i zat i on routine 


Tho 

Mi cr osof t 

MACRO 

Assemb 1 er 


02*20-84 

PAGE 1 

- 4 

Hard 

Disk Init 

ia 1 

zat 

i on 












Hard 

Disk Drive inital 

i zat i on r out i ne . 

77 







PAGE 



78 










79 







PUB L I C 

HD_I N I T 

;Entry from BIOSINIT 

80 










8 1 

OOOO 






HD__I NI T ; 



82 

OOOO 

C6 

06 

OOE2 R 

00 

90 

MOV 

NDRV . 0 

;Initially no drives 

83 

000 6 

E8 

OOOO E 



CAL L 

H I N I T 

; init hard disk 

84 










85 

0009 

OE 





PUSH 

CS 

set buffer addr for read home track 

86 

OOOA 

07 





POP 

ES 


87 

OOOB 

BF 

OOOO E 



MOV 

D I , OFFSET 

BUFFER 

88 

OOOE 

E8 

OOE3 R 



CAL L 

RHOME 

read home 

89 

O0 1 1 

22 

CO 




AND 

AL . AL 

; check any error 

90 

OO 1 3 

74 

OS 




JZ 

0 I N I T2 


92 

00 15 

BB 

0042 R 



MOV 

BX , OFFSET 

HNFMT : print error message 

93 

OO 1 8 

EB 

00 




JMP 

SHORT DINITX 

94 










95 

OO 1 A 

E8 

OOOO E 



0INIT2: CALL 

HINIT 

; re_init hard disk 

96 

OO 1 D 

AO 

OOE2 R 



MOV 

AL . NDRV 

; get # of drives present 

97 

0020 

OA 

CO 




OR 

AL , AL 

; see if any msdos partitions are here 

98 

0022 

75 

08 




JNZ 

DINITY 


99 

0024 

BB 

0082 R 



MOV 

BX . OFFSET 

NOMSDOS ;IF NOT. TELL THE USER 

1 OO 

0027 

E8 

OOOO E 



DINITX: CALL 

PSTR 


101 

002A 

33 

CO 




XOR 

AX , AX 


102 

002C 

C3 





DINITY: RET 


;RETURN # OF DRIVES 

103 










104 







; DEVICE INIT 

ENTRY (HARO 

INIT ALREADY DONE. JUST RETURN INFO) 

105 










106 

O02D 






DSK_1N1T : 



107 

O02D 

8A 

26 

OOE2 R 



■” MOV 

AH . NDRV 


108 

003 1 

2E 

CS 

IE OOOO 

E 

LDS 

BX . CS : t PTRSAVE ] 

109 

0036 

88 

67 

OD 



MOV 

BYTE PTR 

[BX .MEDIA] .AH ; # of drives for MSDOS 

1 1 0 










1 1 1 

0039 

C7 

47 

12 OOOO E 


MOV 

WORD PTR 

[ BX . COUNT ]. OFFSET INI TAB 

1 1 2 

003E 

8C 

4F 

1 4 



MOV 

WORD PTR 

[ BX . COUNT + 2 ] , CS 

1 13 










1 14 

004 1 

C3 





RET 



1 1 6 

0042 

OD 

OA 

57 4 1 

52 

4E 

HNFMT DB 

CR. LF . 'WARNING : The hard disk is not formatted ' 

1 1 7 


49 

4E 

47 3A 

20 

54 




1 18 


68 

65 

20 68 

6 1 

72 




1 1 9 


64 

20 

64 69 

73 

6B 




1 20 


20 

69 

73 20 

6E 

6F 




1 2 1 


74 

20 

66 6F 

72 

6D 




122 


61 

74 

74 65 

64 

20 




123 

006C 

6F 

72 

20 6E 

6F 

74 

DB 

'or not partitioned!' 

124 


20 

70 

6 1 72 

74 

69 




1 25 


74 

69 

6F 6E 

65 

64 




/ 128 


2 1 








127 

O07F 

OD 

OA 

OO 



DB 

CR . LF , 0 


128 










129 

0082 

OD 

OA 

54 68 

65 

72 

NOMSDOS DB 

CR.LF. 'There are ne MS-DOS partitions on ' 

130 


65 

20 

61 72 

85 

20 




131 


6E 

6F 

20 4D 

53 

2D 
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132 

44 

4F 

S3 

20 

70 

61 




133 

72 

74 

69 

74 

69 

6F 




134 

6E 

73 

20 

6F 

6E 

20 




135 

00A6 74 

68 

65 

20 

68 

61 

OB 

' the hard disk. 

’ .CR. LF ,0 

136 

72 

64 

20 

64 

69 

73 




137 

6B 

2E 

OO 

OA 

OO 





1 38 










139 







SUBTTL 

Winchester HOME 

block reader 


8 DPE/DPD bui Ider 
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Winchester HOME 

block 

reader 8 

DPE/DPD bui Ider 


1 40 






PAGE 




141 





; must 

be the 

same order as the equates 


142 










143 

OOB7 

48 4F 

40 

OO 

BM HOM 

db 

'HOM' . 

0 


144 

OOBB 

42 4 1 

54 

OO 

bm“bat 

DB 

' BAT ' . 

0 


145 

OOBF 

44 50 

44 

OO 

BM DPD 

DB 

' DPD ' , 

0 


146 

OOC3 

4F 53 

4E 

OO 

bm“"osn 

DB 

' DSN ' . 

O 


147 

OOC7 

4 1 53 

54 

OO 

bm""ast 

DB 

'AST ' , 

0 


1 48 

OOCB 

50 41 

S3 

OO 

bm_pas 

DB 

' PAS ' . 

0 


149 










150 

OOCF 




HOMEER 


LABEL 

WORD 

home track error word 

1 5 1 

OOCF 

00 



HT ERR 

C 

DB 

O 

home track error code 

152 

OOOO 

OO 



ht”err~ 

ID 

DB 

O 

home track error block 

153 










154 

OOD 1 

OOOO 



ST AST 


DW 

0 

start track # for AST 

155 

0003 

00 



NT AST 


DB 

0 

# of tracks for AST 

156 

0004 

OOOO 



BAT TN 


DW 

0 

BAT track # 

157 

0006 

OO 



bat""sn 


DB 

o 

BAT sector # 

158 

0007 

OOOO 



bat“len 


DW 

O 

BAT length 

159 

0009 

OO 



BK TbN 


DB 

o 

logical block # 

1 60 

OODA 

OOOO 



bk”mec 


DW 

0 

max entry count 

161 

OODC 

OOOO 



bk"ec 


DW 

0 

entry count 

1 62 










1 63 

OODE 

OOOO 



TEMP 


DW 

0 


1 64 

OOEO 

OOOO 



SAVE SEC 

DW 

0 


1 65 

00E2 

OO 



NDRV 


DB 

o 

; F of dr i ver s 



The 
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Winchester HOME 

block 

reader 

8 DPE/DPD builder 

166 






PAGE 




167 





»««*«*« 

*«**»«*»«»««* 

«***«»*»«««*««»»»*»»»»«»»»«««»«»««»«**»«««» 

168 










1 69 






RHOME 

- Read 

'HOM' block and other necessary blocks to build 

1 70 







the logical 

partition and alternate sectors. 

171 







Mor e 

information can be obtained from V2 spec. ODS.MEM 

1 72 










173 






Th i s 

r out i ne 

assumes 

that the RD controller board is installed. 

174 










175 






ENTRY 

ES : DI 

s sector buffer start address. 

176 








It must contain one sector memory (512 bytes). 

1 77 








Since there are more than 1 sector read in this 

178 








r out 

ine, the sector buffer start address. DI. 

179 








will 

be saved in (TEMP). 

1 80 






EXIT : 




181 







AX E 

home track error word 

1 82 








(AL : error code, and AH : error block) 

183 








AL t 

0, no error 

184 








AL < 

1, sector read error (hard error) 

185 








AL = 

2. block ID not found 

186 








AL > 

3. block checksum error 

1 87 








AL c 

4 , no part i t i ons 

1 88 








and 


1 89 








AH « 

0, unknown area 

1 90 








AH s 

1 , ' HOM' block 

1 9 1 








AH : 

2. 'BAT' block 

192 








AH s 

3. 'DPD' block 

193 








AH s 

4. 'OSN' block 

194 








AH : 

5, 'AST' block 

195 








AH * 

6, 'PAS' block 

196 








AH s 

7, PRE-BOOT block 

197 








AH s 

8. BOOT block 

198 










199 







WORD 

HOMEER 

e AX, home track error word. 

200 









which can be examined later. 

201 







WORD 

ST AST 

> start track # for alternate sector area 

202 







BYTE 

NT__AST 

: # of tracks reserved for alternate sector area 

203 










204 





»»»«*»« 



»»»»*»»*«»««*»*«*»«»*«»««««««»«««««» 

205 










206 

OOE3 



1 

4H0ME ; 





207 

OOE3 

FC 




CLD 



set direction forward 

208 

OOE4 

89 

3E OODE R 



MOV 

TEMP . 

DI 

save buffer start addr 

209 

OOE8 

33 

CO 



XOR 

AX . AX 



210 

OOEA 

A3 

OOCF R 



MOV 

HOMEER , AX 

; init error word 

2 1 2 

OOED 

B3 

02 



MOV 

BL . 2 


sector 2 

2 1 3 

OOEF 

33 

02 



XOR 

DX , OX 


track 0 

2 1 4 

OOF1 

B4 

O 1 



MOV 

AH, BID HOM 

; HOM ID 

2 1 5 

OOF3 

E8 

017B R 



CALL 

READINB 

read HOM block 

2 1 6 

OOF6 

75 

42 



JNZ 

RH0M4 

; abor t if error 

2 1 7 










2 1 8 

OOF8 

26 

: 8B 44 40 



MOV 

AX . ES 

: NCYLD_ 

OFF(SI) ; get # of cylinders 

2 1 9 

OOFC 

48 




DEC 

AX 



220 

OOFD 

A3 

OOOO E 



MOV 

MAXTRK, AX 

save max track # 
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26; 8B 44 4A 
A3 OOOO E 
26: 6A 44 4C 

A2 OOOO E 


AX,ES:WPC 0FF[SI1 
PRECOMP , a 7 
AL.ES.STEPR OFFiSI] 
STEPRATE , Al” 


get write pre__comp value 
save pre__comp 
get step rate value 
save step rate 


80 3E 0009 R OO 
88 0104 
75 22 


BK_LBN , O 
AX , 104H 
RH0M4 


check partitioned 
assume no partitions 


26: 8B 54 17 

26; 8A SC 19 
26; 8B 4C 1A 
23 C9 
B8 0104 
74 OF 


OX, WORD PTR ES:OPD_OFF[SI 1 
BL.BYTE PTR ES : 0PD_0FF + 2 [ S I 1 
CX.WORD PTR ES : 0PD_0FF+3tSI 1 
CX,CX ; ch 

AX . 104H ; as 

RH0M4 


; get DPO track number 

I ] get sect or # 

I i get length 

check any entry? 
assume no partitions 


B4 03 
E8 017B R 
75 08 


AH. BID DPO 

REAOINB 

RH0M4 


set block 10 
read DPO block 
abort if error 


E8 013E R 
E8 01FO R 
33 CO 


build hard disk partition 
build hard disk drive OPE 8 DPB 
no error 


A3 OOCF R 
C3 


save home track error word 
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PAGE 


258 

01 3E 



BHPAR : 


259 

01 3E 

8B 

36 OODE R 


MOV 

260 






26 1 

0142 

8B 

OE OODC R 


MOV 

262 

0146 

23 

C9 


AND 

263 

0148 

74 

30 


JZ 

264 

01 4A 

83 

C6 20 


ADD 

265 

01 40 



BHPAR1 : 


266 

01 4D 

26 

80 3C FO 


CMP 

267 

015 1 

75 

22 


JNZ 

268 

0153 

26 

80 7C OB 02 


CMP 

269 

0158 

75 

1 B 


JNZ 

270 






27 1 

O 1 5A 

AO 

OOE2 R 


MOV 

272 

01 5D 

3C 

04 


CMP 

273 

01 5F 

74 

1 9 


JZ 

274 

0161 

FE 

06 00E2 R 


INC 

275 

O 1 65 

E8 

0000 E 


CAL L 

276 






277 

0 1 68 

26 

: 8B 44 OC 


MOV 

278 

O 1 6C 

89 

07 


MOV 

279 

O 1 6E 

26 

; 8B 44 OE 


MOV 

280 

O 1 72 

89 

47 02 


MOV 

28 1 

O 1 75 

83 

C6 20 

BHPAR5 : 

ADD 

282 

0178 

E2 

D3 


LODP 

283 

01 7A 

C3 


BHPAR4 : 

RET 
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249 

250 

251 

252 

253 

254 

255 

256 

257 


Winchester HOME block reader 8 DPE/DPD builder 
PAGE 




ENTRY ; 
EXIT : 




Build Hard disk PARt i t i on first/last track P 
none 


S I . TEMP 

CX . BK_EC 
CX , CX 
BHPAR4 

SI. OFFSET DPD__START_OFF 


get buffer addr 

get entry count 

any entry? 

done i f no ent r y 

point to entry start addr 


BYTE PTR ES : DPDE_FLAG [SI 1 , DPDE INIT 
BHPAR5 “ 

BYTE PTR ES : DPDE_OST [ S I I . MSDOS 
BHPAR5 


check initialized? 


AL , NDRV 
AL , MNPARTS 
BHPAR4 

BYTE PTR NDRV 
GETPEA 

AX. WORD PTR ES ; DPDE_FTN I S I 1 
WORD PTR PART_FTN [ BX ] . AX 
AX. WORD PTR ES : DPDE_L TN I S I 1 
WORD PTR PART__LTN t BX 1 , AX 
SI. OFFSET DPDE__OFF 
BHPAR 1 


skip if not 

check this OS type? 

skip this if wrong OS 

get # of drives so far 
check max 

done if max drives reached 

update # of drives 

get partition entry addr 

get f i r St track # 
save to partition table 
get last track # 
save to partition table 
set to next DPD entry 
loop for all entries 
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284 

285 

286 

287 

288 

289 

290 

29 1 

292 

293 

294 

295 

296 

297 

298 

299 

300 

30 1 

302 

303 

304 

305 

306 017B 


307 

01 7B 

53 



308 

01 7C 

52 



309 

0170 

E8 

0 187 R 


310 

O 1 80 

5A 



31 1 

018 1 

SB 



312 

0182 

75 

oi 


313 

0184 

C3 



314 





315 

0185 




3 1 6 

0185 

42 



317 

0186 

42 



3 1 8 





3 1 9 





320 

0187 




32 1 

0187 

88 

26 OODO 

R 

322 

01 8B 

E8 

OOOO E 


323 

01 8E 

8B 

3E OODE 

R 

324 

0192 

B9 

0001 


325 

0195 

C6 

06 OOOO 

E 

326 

01 9A 

E8 

OOOO E 


327 

01 9D 

BO 

OI 


328 

01 9F 

75 

4A 


329 





330 





331 





332 

01 A1 

8B 

3E OODE 

R 

333 

01 AS 

AO 

OODO R 


334 

01 A8 

FE 

C8 


335 

01 AA 

98 



336 

01 AB 

0 1 

EO 


337 

01 AD 

D 1 

EO 


338 

01 AF 

BE 

OOB7 R 



PAGE 

**»»**♦**»*******»***»*»***»»»»»****»********»*******»*»******* 

READIN - This routine read in a Wini sector into the buffer area. 
It also checks the correct block ID and checksum. 

Some useful data are also being colected. 

ENTRY : 

AH : block ID 

BL = sector number 

DX : logical track number 

ES:(TEMP) s sector buffer start addr 

EXIT: 

AX = error word defined in RHOME routine 
SI : (TEMP) 

2 flag is set if error 

BYTE BK_LBN = logical block number, byte 3 
WORD BK_MEC s max entry count, byte 6-7 
WORD BK_EC s entry count, byte 8-9 


PUSH BX 

PUSH DX 

CALL READIN 

POP DX 

POP BX 

JNZ READINB1 

RET 

READ I NB 1 : 

INC DX 

INC DX 

; JMP READIN 


READ I N : 

MOV HT_ERR_ID . AH 

CALL CLTPN “ 

MOV 0 I . TEMP 

MOV CX , 1 

MOV BYTE PTR X L T__F , O 

CALL HREAD 

MOV AL . 1 

JNZ READIN10 


check correct block ID 


MOV D I , TEMP 

MOV AL,HT_ERR_ID 

DEC AL 

CBW 
SHL 
SHL 
MOV 


save sector P 
save track # 


; try to read the alternate block 


save block ID 
convert to physical # 
get buffer start addr 
set sector count 
set phys i ca 1 flag 
read sector 
assume hard error 


get buffer addr 
get block ID 


; *4 


AX , 1 
AX , 1 

SI. OFFSET BM_HOM 


get string start addr 
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S I . AX 
COMPS 
AL , 2 

READ1N10 


assume ID not found 


check correct check sum 


SI , TEMP 
CX ,512/2 
BX , BX 

ES;WORD PTR [SI] 

BX . AX 

READIN3 

BX , BX 

AL , 3 

REA0IN1O 


get buffer start addr 
get sector count 
init check sum 

get data 

add to check sum 
loop for whole sector 
checksumso? 

assume check sum error 


save some useful information 

MOV SI, TEMP ; get buffer addr 

MOV AL,BYTE PTR ES:BK_LBN OFF[SI] ; get logical block number 

MOV BK_LBN,AL ” ; save it 

MOV AX,WORO PTR ES ; BK_ME C_OF F [ S I ] ; get max entry count 

MOV BK_MEC.AX ; save it 

MOV AX, WORD PTR ES : BK_EC__OFF [ S I ] ; get entry count 

MOV BK_EC,AX ; save it 

XOR AL,AL ; no error 

0 : 

MOV AH.HT ERR ID ; restore ID 


Winchester HOME block reader A DPE/DPD builder 


build hard disk logical drives 

(PARTITION) should contain first A last track 

number for all drives, if any one of the 
is not present, the first track number s 
cont a i n a O . 

DPB are bu i 1 t 
ALL 


DI , OFFSET PARTITION 
S I . OFFSET HDSKO 
CX .MNPARTS 


do all partitions 


BX , PART_FTN I 0 I ] 
CX,PART_LTN[DI 1 
BX , BX 
BHDRV 1 


get first track # 
get last track # 
check this partition p 
Skip if not 


01 , PART_S I 2E 
SI , DPB OFF 


save OPE 

build this OPE A DPB 
restore DPE 

set to next partition 

restore partition cour 
loop until all partiti 


Build Disk Parameter Block Fields 
for Winchester logical disk drive 

BX s first track # 

CX c last track # 

SI s DPE addr 


02 1 3 

0213 2B CB 
02 15 4*1 

0216 DI El 
0216 DI El 
021A DI El 


total tracks 


total sectors 


02-20-S4 


PAGE 


1-13 
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Winchester HOME 

block 

reader A OPE/DPD 

bui Ider 

425 

021 E 

89 

4C 08 


MOV 

WORD PTR 

SECTORStSI ] .CX 

426 

022 1 

BO 

0002 


MOV 

BP , 2 


: assume 1 sectors per FAT 

427 

0224 



BDPB1 : 





428 

0224 

8B 

Cl 


MOV 

AX . CX 


; get total sectors 

429 

0226 

20 

0030 


SUB 

AX , 324>1 6 


; 2 reserved trackS't-IS sectors f 

430 

0229 

2B 

C5 


SUB 

AX , BP 


; - FAT s total sectors for data 

431 

022B 

01 

E8 


SHR 

AX . 1 


; / 4 sectors per cluster 

432 

0220 

01 

E8 


SHR 

AX . 1 



433 

022F 

8B 

08 


MOV 

BX . AX 


; *1.5 

434 

023 1 

01 

E8 


SHR 

AX . 1 


; /2 

435 

0233 

03 

C3 


ADO 

AX . BX 



436 

0235 

05 

0004 


ADD 

AX . 4 


; 4-3 and 1 may be overflow 

437 

0238 

BB 

0200 


MOV 

BX . 512 



438 

023B 

33 

02 


XOR 

OX . OX 


;THIS MAY FIX A BUG PIS 

439 

0230 

F7 

F3 


01 V 

BX 



440 

023F 

25 

OOFF 


AND 

AX . OFFH 


: don't remove this instruction 

441 

0242 

40 



INC 

AX 



442 

0243 

03 

CO 


ADD 

AX . AX 


; 2 copies of FAT 

443 

0245 

3B 

C5 


CMP 

AX . BP 


; enough sector for FAT 

444 

0247 

8B 

E8 


MOV 

BP . AX 



445 

0249 

7C 

09 


JL 

BDPB 1 



446 

024B 

01 

E8 


SHR 

AX . 1 


; 1 FAT 

447 

0240 

89 

44 OB 


MOV 

WORD PTR 

FATSEC 

(SI ] . AX 

448 

0250 

C3 



RET 
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449 

450 

451 

452 

453 

454 

455 

456 

457 

458 

459 

460 
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COMPS - compare string 

ENTRY: OS ; S I s message to compare end with O 

ES:DI s buffer addr 
EXIT: 2 FLAG is set if equal 

USES: AL. SI. DI 

k************************************************************** 


461 

0251 



COMPS : 




462 

025 1 



C0MPS2 : 




463 

025 1 

AC 



LODSB 


; get byte 

464 

0252 

22 

CO 


AND 

AL . AL 

; end of st r i ng? 

465 

0254 

74 

03 


JZ 

COMPS 1 

done, if yes 

466 

0256 

AE 



SCASB 


same byte? 

467 

0257 

74 

F8 


JZ 

C0MPS2 

i f equa 1 , keep 

468 

0259 



C0MPS1 : 




469 

0259 

C3 



RET 




DIR 
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^AGI 


1 > IS 
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471 






RAGE 


472 

025A 




UR BAT: 


473 

025A 

6C 

C6 



MOV 

AX.es 

474 

025C 

6E 

08 



MOV 

OS. AX 

475 

025E 

6E 

CO 



MOV 

ES , AX 

476 

0260 

BF 

OOOO E 



MOV 

01. OFFSET BUFFER 

477 

0283 

6B 

16 02F2 

R 


MOV 

OX. TEMP TRK 

478 

0267 

8A 

IE 02F4 

R 


MOV 

BL.TEMP SEC 

478 






JMR 

WT BAD B 

4BO 








461 







462 








463 






WT BAD 

B - write bad bit 

464 








465 






ENTRY : 


466 







OX • track # 

487 







BL s sector a 

466 







BS:OI t buffer 

468 






NOTE : 

all BAT must stay 

480 








48 1 








482 








483 

0268 




WT BAD B : 


484 

0268 

68 

IE OOEO 

R 


MOV 

SAVE SEC.BX 

485 

026F 

88 

3E OODE 

R 


MOV 

TEMP .01 

486 

0273 

88 

C2 



MOV 

AX . OX 

487 

0275 

88 

16 OOD4 

R 


MOV 

DX.BAT TN 

486 

0278 

8A 

IE 0006 

R 


MOV 

BL.BAT SN 

488 

027D 

88 

OE 0007 

R 


MOV 

eX.BAT LEN 

500 

0281 




WT BAOB 1 : 


501 

0281 

3D 

OOFA 



CMF 

AX . 250 

502 

0284 

72 

08 



JB 


503 

0286 

FE 

C3 



INC 

BL 

504 

0288 

2D 

OOFA 



SUB 

AX . 250 

505 

028B 

E2 

F4 



LOOP 

WT BA0B1 

506 

028D 

C3 




RET 


507 

028E 




WT BADB4; 


508 

028E 

52 




PUSH 

OX 

508 

028F 

53 




PUSH 

BX 

5 10 

0280 

50 




PUSH 

AX 

5 1 1 

028 1 

B4 

02 



MOV 

AH. BID BAT 

5 1 2 

0283 

E8 

017B R 



CALL 

REAOINB 

513 

0296 

58 




POP 

AX 

514 

0287 

75 

56 



JN2 

WT_BA0B5 

515 








51 6 

0299 

88 

3E OODE 

R 


MOV 

DI . TEMP 

5 1 7 

029D 

8B 

F7 



MOV 

SI . DI 

5 1 8 

029F 

0 1 

EO 



SHL 

AX . 1 

518 

02A1 

03 

FO 



ADO 

SI .AX 

520 

02A3 

88 

OE OOEO 

R 


MOV 

CX.SAVE SEC 

521 

02A7 

49 




DEC 

CX 

522 

02A8 

B8 

0001 



MOV 

AX . 1 

523 

02AB 

D3 

EO 



SHL 

AX . CL 

524 

02AD 

26 

: 09 44 

OC 


OR 

ES : 12[SI ] .AX 

525 

0281 

26 

: C7 45 

04 OOOO 


MOV 

ESiWORO PTR 4(DI 
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Wi nchest er 

HOME block 

reader 8 OPE/DPD bu 

526 

02B7 

33 

OB 



XOR 

BX . BX 

527 

02B9 

8B 

F7 



MOV 

SI . DI 

528 

02BB 

B8 

0100 



MOV 

CX . 5 12/2 

529 

02BE 




WT_ 

BCLP : 


530 

02BE 

26 : 

AO 



LOOS 

ES:WORD PTR ISI] 

53 1 

02C0 

03 

08 



ADO 

BX . AX 

532 

02C2 

E2 

FA 



LOOP 

WT__BCLP 

533 








534 

02C4 

F7 

OB 



NEC 

BX 

535 

02C6 

26 : 

89 50 

04 


MOV 

ES : 4 lOI 1 . BX 

536 

02CA 

SB 




POP 

BX 

537 

02CB 

BA 




POP 

OX 

538 

02CC 

B9 

OO01 



MOV 

CX . 1 

539 

02CF 

S3 




PUSH 

BX 

540 

02D0 

52 




PUSH 

OX 

541 

0201 

57 




PUSH 

01 

542 

0202 

5 1 




PUSH 

CX 

543 

0203 

E8 

OOOO E 



CALL 

CLTPN 

544 

0206 

C6 

06 OOOO 

E OO 


MOV 

BYTE PTR XLT F,0 

545 

02DB 

E8 

OOOO E 



CALL 

HWRITE ” 

546 

O20E 

59 




POP 

CX 

547 

02DF 

5F 




POP 

DI 

548 

02E0 

SA 




POP 

OX 

549 

02E1 

5B 




POP 

BX 

550 

02E2 

42 




INC 

OX 

551 

02E3 

42 




INC 

OX 

552 

02E4 

E8 

OOOO E 



CALL 

CLTPN 

553 

02E7 

C6 

06 OOOO 

E OO 


MOV 

BYTE PTR XLT F.O 

554 

02EC 

E9 

OOOO E 



JMP 

HWRITE ” 

555 








556 

02EF 




WT 

BADB5 : 


557 

02EF 

58 




POP 

AX 

558 

02F0 

58 




POP 

AX 

559 

02F1 

C3 




RET 


560 








56 1 

02F2 

OOOO 


TEMP TRK 

OW O 

562 

02F4 

OO 



TEMPOS EC 

OB 0 


563 

564 

565 


;SETUR ES:DS: 


sat up working buffar ES;OI 
gat bad track # 
and sector # 


BAT 


same track 


save sactor # 
sava buffar addr 
; gat bad track # 

; gat BAT track # 
gat BAT sactor # 
got langth 

; chock in this block 

by compare with entry size 
; sat to naxt sactor 


can't find it. don't update BAT 

save track # 
save sector # 
save track offset in BAT 
sat ID 

read the sector 

restore offset 

if error don't update BAT 

get buffer addr 
get buffer addr 
word offset 

gat sactor # 
base o 
sat 1 bit 

shift into position 
sat the bit 
clear checksum 


init new checksum 
get buffer offset 
# of words in buffer 

get a word 
accumulate result 
do ' am all 

comp 1 i mant 
store new checksum 
restore sector 
and track 
write 1 sect or 
Save for 2nd write 


: convert to physical # 
set translate flag 
: update the bad bit 

restore write params 


Step to 2nd copy of BAT 

; convert to physical # 

; set translate flag 
: update the bad bit and RETURN 


clean stack and exit 


02F5 


CODE 


ENDS 

END 
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Structures and records: 





Name 

Width 

# fields 



Sh i ft 

Width 

Mask 

Init ial 

DBP 

0013 

OOOB 



SECS2 

OOOO 




ALLOC 

0002 




RESSEC 

0003 




FATS 

0005 




MAXDIR 

0006 




SECTORS 

0008 




MEDIAID 

OOOA 




FATSEC 

OOOB 




SECTRK 

OOOD 




HEADS 

OOOF 




HIDDEN 

00 1 1 




I ODAT 

0016 

0009 



CMDLEN 

OOOO 




UNIT 

0O01 




CMD 

0002 




STATUSW 

0003 




MEDIA 

OOOD 




TRANS 

OOOE 




COUNT 

00 12 




START 

00 14 




Segments and groups: 





Name 

S i ze 

align 

comb i ne 

c lass 

CGROUP 

GROUP 




CODE 

02F5 

BYTE 

PUBL I C 

' CODE ' 

Symbo 1 s : 





Name 

Type 

Va 1 ue 

Attr 


ABRTC 

Number 

0004 



AST OFF 

Number 

0026 



ATRETRY 

Number 

OOOO 



BADBD 

Number 

0080 



BAT LEN 

L WORD 

0007 

CODE 


BAT OFF 

Number 

OO 1 2 



BAT SN 

L BYTE 

0006 

CODE 


bat“*tn 

L WORD 

0004 

CODE 


BDPB 

L NEAR 

02 1 3 

CODE 


BDPB 1 

L NEAR 

0224 

CODE 


BMDRV 

L NEAR 

0 1 FO 

CODE 


BHDRV1 

L NEAR 

0208 

CODE 


BHDRV2 

L NEAR 

O 1 F9 

CODE 


BHPAR 

L NEAR 

0 1 3E 

CODE 


BHPARl 

L NEAR 

0 140 

CODE 


BHPAR4 

L NEAR 

O 1 7A 

CODE 


BHPAR5 

L NEAR 

0 175 

CODE 


B I D AST 

Number 

0005 
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BID_BAT Number 0002 

BID__BOT Number 0008 

BID_DPD Number 0003 

BID__HOM Number OO0 1 

BID__OSN Number 0004 

BID___PAS Number OOOB 

BID_PBT Number 0007 

BID__UKN Number OOOO 

BITO Number OO0 1 

BIT1 Number 0002 

BIT1S Number 8000 

BIT2 Number 0004 

BIT3 Number 0008 

BIT4 Number O0 1 0 

BITS Number 0020 

BITS Number 0040 

BIT? Number 0080 

BK_EC L WORD OODC CODE 

BK___EC__OFF Number 0008 

BK_LBN . L BYTE 0009 CODE 

BK_LBN__OFF Number 0003 

BK_MEC L WORD OODA CODE 

BK__MEC__OFF Number OOOB 

BM_AST” L BYTE OOC7 CODE 

BM__BAT L BYTE OOBB CODE 

BM__DPD L BYTE OOBF CODE 

BM_HOM L BYTE OOB7 CODE 

BM_OSN L BYTE 00C3 CODE 

BM__PAS L BYTE OOCB CODE 

BOOT__OFF Number 002 1 

buffer V WORD OOOO CODE External 

CBSY Number 0080 

CBSY2 Number OO0 1 

CLRIL Number 0004 

CLRSPL Number 0008 

CLTPN L NEAR OOOO CODE External 

CMDIP Number 0002 

COMPS L NEAR 025 1 CODE 

C0MPS1 L NEAR 0259 CODE 

C0MPS2 L NEAR 025 1 CODE 

CPM8680 Number OO0 1 

CR Number OOOD 

CRCER Number 0040 

CTRL__0 Number 0011 

CTRL_S Number 0013 

CTRL_Z Number 00 1 A 

CYLDH Number 0065 

CYLDL Number 0064 

DAMNF Number OO0 1 

data Number 0060 

DATARO Number 0008 

DINIT2 L NEAR 00 1 A CODE 

DINITX L NEAR 0027 CODE 

DINITY L NEAR 002C CODE 

DISKDF Number 0005 
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DPB_0FF Numbar 0013 

DPDC__FLAG Numbar OOOO 

DPDE~FTN Numbar OOOC 

OPDE~INIT Numbar OOFO 

DPOE_LTN Numbar OOOE 

DPDE^LU Numbar 0O01 

DPDE”oFF Numbar 0020 

DPDE_OST Numbar OOOB 

DPOE_PN Numbar 0002 

DPDE__PON Numbar OOOA 

DPD__OFF Numbar 0017 

DPD__START__OFF Numbar 0020 

DRDY Numbar 0040 

DRDY2 Numbar 0040 

DRIVEO Numbar OOOO 

0RIVE1 Numbar 0008 

0RIVE2 Numbar O0 1 0 

DRIVE3 Numbar 0018 

DRIVEOF Numbar 0003 

DRIVEM Numbar 0018 

DRVSEL Numbar 0001 

DSK_INIT L NEAR 0020 CODE Global 

DSTATO Numbar 0068 

DSTAT1 Number 0069 

DWRTF Numbar 0020 

DWRTF2 Number 0020 

ERRF Number 0001 

ERROR Number 0061 

FALSE Number OOOO 

FMTTRK Number 0050 

GETFTN L NEAR OOOO CODE External 

CETPEA L NEAR OOOO CODE External 

HDIR Number 0008 

HDISK Number 0004 

HDSKO V BYTE OOOO CODE External 

HD_INIT L NEAR OOOO CODE Global 

HEADO Number OOOO 

HEAD02 Number OOOO 

HEAD 1 Number 0001 

HEAD12 Number 0002 

HEA02 Number 0002 

HEA022 Number 0004 

HEAD3 Number 0003 

HEA032 Number 0006 

HEADH Number 0007 

HEADM2 Number OOOE 

HFORMAT L NEAR OOOO CODE External 

HINIT L NEAR OOOO CODE External 

HIVEC__A Number 0114 

HIVEC”b Number 0294 

HMCHK L NEAR OOOO CODE External 

HNFMT L BYTE 0042 CODE Global 

HOMEER L WORD OOCF CODE 

HREAD L NEAR OOOO CODE External 

HT_ERR_C L BYTE OOCF CODE 
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HT ERR ID 

L BYTE 

OODO 

CODE 


HVDISK 

L NEAR 

OOOO 

CODE 

Ext er na 1 

HWRITE 

L NEAR 

OOOO 

CODE 

Ext er na 1 

HWRITEV. . 

L NEAR 

OOOO 

CODE 

Ext er na 1 

I DB I T . . . . 

Number 

OOEO 



IDBITV 

N umber 

OOAO 



IDNF 

Number 

0010 



INI TAB 

V WORD 

OOOO 

CODE 

Ext er na 1 

INTHDL 

L NEAR 

OOOO 

CODE 

Ext er na 1 

IF 

Number 

OOOA 



LINDEX 

Number 

0002 



LSTEPP 

Number 

0004 



MAXTRK 

V WORD 

OOOO 

CODE 

Ext er na 1 

MNPARTS 

N umber 

0004 



MSCTF 

N umber 

0004 



MSDOS 

N umber 

0002 



NCYLD DFF 

N umber 

0040 



NDRV 

L BYTE 

OOE2 

CODE 

G 1 oba 1 

NOMSDOS 

L BYTE 

0082 

CODE 


NT AST 

L BYTE 

OOD3 

CODE 


NT AST OFF 

Number 

002D 



NUMHEAD 

Number 

0004 



OSN OFF 

Number 

OO 1 C 



PART I T ION 

V WORD 

OOOO 

CODE 

Ext er na 1 

PART FTN 

Number 

OOOO 



PART LTN 

Number 

0002 



PART PAS 

Number 

0004 



PART SIZE 

Number 

- OOOO 


Ext er na 1 

pase“off . . 

Number 

0005 



PAS ASN 

Number 

0004 



PAS ATN 

Number 

0003 



PAS BSN 

Number 

0002 



PAS BTN 

Number 

OOOO 



PRECOMP 

V WORD 

OOOO 

CODE 

Ext er na 1 

PRE READ 

Alias 

FALSE 



PSTR 

L NEAR 

OOOO 

CODE 

Ext er na 1 

PTRSAVE 

V DWORD 

OOOO 

CODE 

Ext er na 1 

RDBASE 

Number 

0060 



RDCMD 

Number 

0067 



RDCMD2 

Number 

00 6 8 



RDINTF 

Number 

0008 



ROREAD 

Number 

0020 



RDSTAT 

Number 

0067 



RDWRITE 

Number 

0030 



READIN 

L NEAR 

0187 

CODE 

, 

REA0IN1O 

L NEAR 

01 EB 

CODE 


READIN3 

L NEAR 

01 C4 

CODE 


READINB 

L NEAR 

01 7B 

CODE 


READINB1 

L NEAR 

0185 

CODE 


RESTOR 

Number 

0010 



RH0M4 

L NEAR 

01 3A 

CODE 


RHONE 

L NEAR 

OOE3 

CODE 

Global 

SAVE SEC 

L WORD 

OOEO 

CODE 


SBUFR 

Number 

000 1 



SCANIO 

Number 

0040 
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SCTEXT Number OOSO 

SDH Number OOtS 

SCCPTRK Number ooio 

SECSIZE Number 0200 

SECTC Number 0082 

SECTN Number 0063 

SBCTSZ Number 0060 

SEEK Number 0070 

SEEKC Number OOIO 

SEEKC2 Number 0010 

SERR Number OOOF 

SINIT Number 0002 

SSCTF Number OOOO 

SSZ126 Number 0060 

SSZ1K Number 0040 

SSZ256 Number OOOO 

SSZ512 Number 0020 

STEPRO Number OOOO 

STEPR1 Number OOOl 

STEPR2 Number 0002 

STEPR3 Number 0003 

STEPR4 Number 0004 

STEPR5 Number OOOS 

STEPR6 Number 0006 

STEPR7 Number 0007 

STEPR8 Number 0006 

STEPR9 Number 0009 

STEPRA Number OOOA 

STEPRATE V BYTE OOOO CODE External 

STEPRB Number OOOB 

STEPRC Number OOOC 

STEPRD Number OOOD 

STEPRE Number OOOE 

STEPRF Number OOOF 

STEPR OFF Number 004C 

ST AS? L WORD OOD 1 CODE 

ST^AST OFF Number 002B 

TEMP L WORD OODE CODE 

TEMP SEC L BYTE 02F4 CODE Global 

TEMP~TRK L WORD 02F2 CODE Global 

TRK02 Number 0080 

TRKOE Number 0002 

TRUE Number - OOOl 

UP_BAT L NEAR 02SA CODE Global 

WGATE Number OOIO 

WINI OFFSET Number 0094 

WINI^SEG Number 0096 

WPC OFF Number 004A 

WPRCMP Number 0061 

WPRSNT Number OOOl 

WTVERR Number OOOD 

WT BADB1 I NEAR 0281 CODE 

WT^BAOBA L NEAR 028E CODE 

WT^BAOBS L NEAR 02EF CODE 

WT^'bAD B L NEAR 026B CODE 
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WT BCLP L NEAR 02BE CODE 

XBB BO Number 0008 

XBB'bS Number OOOA 

XBB_CN Number 0004 

XBB DISKF Number oooo 

XBB*~DSN Number 0003 

XBB^ERRC Number OOOC 

XBB_LON Number OOOl 

XBB^SC Number OOOB 

XBB*~SN Number 0002 

XCPRSNT Number 0002 

XLT F V BYTE OOOO CODE External 

XDPTION V BYTE OOOO CODE External 

warning Severe 
Errors Errors 
O O 



Hard Dfsk Init i«1 f i«t ion 


Symbol Cross Roforonco 


(# is definition) Crof-1 


ABRTC 29# 

ALLOC BS# 

AST OFF 29# 

ATRETRY 29# 

BADBD 29# 

BAT LEN IBS# 499 

BAT OFF 29# 

BAT“sN 1B7# 498 

BAT_TN IBB# 497 

BOFB 398 418# 

BDPB 1 427# 445 

BHDRV 243 384# 

BH0RV1 393 398# 

BHORV2 388# 402 

BHPAR 242 2B8# 

BHPARI 28B# 282 

BHPAR4 263 273 283# 

BHPARS 267 269 281# 

BID_AST 29# 

BIO^BAT 29# SI 1 

B10“B0T 29# 

BID”dPD 29# 238 

BIO HOM 29# 214 

BIO^OSN 29# 

BID"”pAS 29# 

BIO*“PBT 29# 

BID”uKN 29# 

BITO 29# 

BIT1 29# 

BIT15 29# 

BIT2 29# 

BIT3 29# 

BIT4 29# 

BITS 29# 

BITS 29# 

BIT7 29# 

B K_E C 161# 261 365 

BK_EC_OFF 29# 364 

BK_LBN 159# 227 381 

BK_LBN_OFF 29# 360 

BK_MEC 160# 363 

BK_MEC OFF 29# 362 

BM_AST 147# 

BM_BAT 144# 

BM_OPD 145# 

BM_HOM 143# 338 

BM_OSN 146# 

BM__PAS 148# 

BOOT__OFF 29# 

BUFFER 23# 87 476 

CBSY 29# 

CBSY2 29# 

CGROUP 12 14 14 14 14 

CLRIL 29# 

CLRSPL 29# 
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Symbol Cross Rafarence 


( # is 

def i n i t i on ) 

Cr ef 

CLTPN 

2 1 # 

322 

543 

552 


CMO 

39# 





CMOIP 

29# 





CMDLEN 

37# 





CODE 

12 

1 3# 

1 3 

564 


COMPS 

340 

461# 




COMPS 1 

465 

468# 




C0MPS2 

462# 

467 




COUNT 

47# 

1 1 1 

1 1 2 



CPM8680 

29# 





CR 

29# 

1 1 6 

127 

129 

137 

CRCER 

29# 





CTRL 0 

29# 





CTRL S 

29# 





CTRL 2 

29# 






CYLOH . 
CYLOL . 


29# 

29# 


OAMNF .... 
OATA .... 
DATARO . . . 

OBP 

0INIT2 . . . 

OINITX . . . 

OINITY . . . 

OISKOF . . . 

OPB OFF . . . 

DPOE FLAG. . 

opoe“ftn . . 
opoe”init. . 

OPOE~LTN . . 

dpoe“"lu. . . 

DPOE^OFF . . 

DPOE*"OST . . 

OPDE^PN. . . 

OPOE-PON . . 

OPO_OFF . . . 

OPO START OFF 
OROY . . " . 

0R0Y2. . . . 

ORIVEO . . . 

0RIVE1 . . . 

DRIVE2 . . . 

0RIVE3 . . . 

ORIVEOF. . . 

ORIVEM . . . 

ORVSEL . . . 

OSK_INIT . . 

OSTATO . . . 

I 0STAT1 . . . 

loWRTF. . . . 

I DWRTF2 . . . 


29# 

29# 

29# 

53# 

90 

93 

98 

29# 

74# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

29# 

26 

29# 

29# 

29# 

29# 


72 
95# 
1 OO# 
1 02 # 

400 

266 

277 

266 

279 

28 1 
268 


231 232 233 

264 


106# 


ERRF 29# 

ERROR 29# 


FALSE 


29# 


29 
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Symbol Cross Raforanca (# is dafinition) Craf~3 

FATS SO# 

FATSEC S4# 447 

FMTTRK 29# 

CETFTN 21# 

CETPEA 21# 275 


HDIR 29# 

HDISK 28# 

HDSKO 19# 386 

HD INIT 27 79 81# 

HEADO 29# 

HEAD02 29# 

HEAD1 29# 

HEAD12 29# 

HEA02 29# 

HEAD22 29# 

HEAD3 29# 

HEA032 29# 

HEADM 29# 

HEA0M2 29# 

HEADS 69# 

HFORMAT 17# 

HIDDEN 70# 

HINIT 17# 83 95 

HIVEC_A 29# 

HIVEC B 29# 

HMCHK” 17# 

HNFMT 26 92 1 1 6# 

HOMEER 150# 210 246 

HREAO 16# 326 

HT ERR_C 151# 

HT‘“eRR_ID 152# 321 333 368 

HVDISK 18# 

HWRITE 16# 545 554 

HWRI TEV 16# 


IDBIT . 
IDBITV 
IDNF . 
IN1__TAB 
I NTHDL 
I ODAT . 



LF 29# 1 16 127 129 137 

LINDEX 29# 

LSTEPP 29# 


MAXDIR 61# 

MAXTRK 22# 220 

MEDIA 45# 109 

MEDIAID 63# 

MNPARTS 31# 272 387 

MSCTF 29# 

MSDOS 29# 268 



PARTITION 20# 385 

PART FTN 29# 278 390 

PART~LTN 29# 280 39 1 

PART_PAS 29# 

PART SIZE 23# 399 

PASE”oFF 29# 

PAS_ASN 29# 

PAS ATN 29# 

PAS'~BSN 29# 

PAS“"BTN 29# 

PRECOMP 22# 222 

PRE_READ 29# 

PSTR 18# 100 

PTRSAVE 19# 108 


RDBASE 29# 29 29 29 29 29 29 29 29 29 29 29 29 

ROCMD 29# 

RDCM02 29# 

RDINTF 29# 

ROREAD 29# 

RDSTAT 29# 

RDWRITE 29# 

REAOIN 309 320# 

READIN10 328 342 355 367# 

READIN3 349# 352 

READINB 215 239 306# 512 

REA0INB1 312 315# 

RESSEC 59# 

RESTOR 29# 

RH0M4 21 6 229 236 240 245# 

RHOME 26 88 206# 


SAVE SEC 164# 494 520 

SBUFR 29# 

SCANID 29# 

SCTEXT 29# 

SDH 29# 

SECPTRK 29# 

SECSI2E 29# 

SECS2 57# 

SECTC 29# 

SECTN 29# 

SECTORS 62# 

SECTRK 68# 

SECTSZ 29# 

SEEK 29# 

SEEKC 29# 

SEEKC2 29# 

SERR 29# 
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Symbol Cross Rofarence 


(# is dafinitlon) Craf-5 


SINIT 29# 

SSCTF 29# 

SSZ128 29# 

SSZ1K 29# 

SSZ2S6 29# 

SSZS12 29# 

START 48# 

STATUSW 40# 

STEPRO 29# 

STEPR1 29# 

STBPR2 29# 

STEPR3 29# 

STEPR4 29# 

STEPR5 29# 

STEPR6 29# 

STEPR7 29# 

STEPR8 29# 

STEPR9 29# 

STEPRA 29# 

STEPRATE 22# 224 

STEPRB 29# 

STEPRC 29# 

STEPRD 29# 

STEPRE 29# 

STEPRF 29# 

STEPR_OFF 29# 223 

ST_AST 1B4# 

ST_AST__OFF 29# 

temp 163# 208 259 323 332 346 359 495 516 

TEMP SEC 27 478 562# 

TEMP TRK 27 477 561# 

TRANS 46# 

TRK02 29# 

TRKOE 29# 

TRUE 29# 29 

UNIT 38# 

UP__BAT 27 472# 

WCATE 29# 

WINI__OFFSET 29# 

WINI_SEC 29# 

WPC_OFF 29# 221 

WPRCMP 29# 

WPRSNT 29# 

WTVERR 29# 

WT_BADB1 500# 505 

WT_BADB4 502 507# 

WT BAOBS 514 556# 

WT_BAD_8 493# 

WT_BCLP 529# 532 

XBB_BO 29# 

XBB BS 29# 

XBB CN 29# 

XBB DISKF 29# 


Hard Disk Initialization 


Symbol Cross Reference 


(# is definition) Cref-6 


XBB_OSN 29# 

XBB ERRC ..... 29# 

XBB”lDN 29# 

XBB_SC 29# 

XBB_SN 29# 

XCPRSNT. 29# 

XLT__F 22# 325 544 553 

XOPTION 24# 
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1 




PAGE 

80.132 


2 




TITLE 

Character 10 

for MSOOS 2.00 

3 




NAME 

CHARACT 


5 




COMPANY 

CONFIDENTIAL 


6 




Copyright (C) 1983 Di 

gital Equipment Corporation 

7 




All rights reserved. 


9 

10 
1 1 




10/04/83 



CGROUP 

GROUP COOE 


12 

0000 

COOE 

SEGMENT 

BYTE PUBLIC * 

CODE' 

13 

14 

15 


ASSUME 

CS:CGROUP, OS:CGROUP, 

ES :CGROUP 




PUBLIC 

CON. AUX. PRN 

. CLK. AUX2 

1 6 




PUBLIC 

CLKISR. INTRET. CLK 60 SO. CLK 16 20. CLK AOJ. TICKER 

17 

1 8 
1 9 




PUBLIC 

OUTHEX. PSTR. 

FASTCON 




EXTRN 

RUPT7201 :NEAR 

. INITCOM.NEAR 

20 




EXTRN 

PRG7201 : NEAR. 

DFLT7201 :NEAR. DFLTBUF : NEAR . RDSETUP:NEAR 

21 




EXTRN 

RCVENA : NEAR, 

RCVDIS-.NEAR. INSTATrNEAR, INCHAR:NEAR 

22 




EXTRN 

GETCHAR:NEAR. 

OUTSTAT ; NEAR. OUTCHAR-.NEAR 

23 




EXTRN 

PUTCHAR:NEAR. 

OUTNOW:NEAR, ROMODEM:NEAR 

24 




EXTRN 

SETMODEM: NEAR 

. BRKON:NEAR, BRKOFF : NEAR 

25 




EXTRN 

RCV INT : NEAR, 

RCVCANCEL :NEAR. XMTMTY;NEAR 

26 




EXTRN 

XMTCANCEL : NEAR, HACK720 1 : NE AR , VECT720 1 ; NEAR 

27 




EXTRN 

STATCHG : NEAR. 

STCANCEL : NEAR 

28 







29 




EXTRN 

STRATEGY : NEAR 

. PTRSAVE : DWORD 

30 




EXTRN 

OSKTMR ; BYTE 
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31 .LIST 

32 


33 

: EEOO 

SYSRAM 

EOU 

OEEOOH 

: SYSRAM segment 

34 

» 0FB7 

ESCSTR 

ECU 

OFB7H 

: 8 bit char buffer 

35 

s OFCC 

STRINX 

EOU 

OFCCH 

; string index 

36 

: 0014 

ESCOFF 

EOU 

STRINX-ESCSTR- 1 



( 
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37 PAGE 

38 

39 Device command dispatch tables. 

40 


41 

oooo 

00B5 

R 

CONTBL: DW 

RETURN 

0 

not used 

42 

0002 

OOB5 

R 

DW 

RETURN 

1 

not used 

43 

0004 

OOB5 

R 

DW 

RETURN 

2 

not used 

44 

0006 

OOAC 

R 

DW 

CMDERR 

3 

reserved 

4S 

0008 

OOEO 

R 

DW 

CONIN 

4 

read 

46 

OOOA 

OOCO 

R 

DW 

CDNINXDR 

5 

non-d. reed 

47 

OOOC 

OOE3 

R 

DW 

CONISTAT 

6 

input status 

48 

OOOE 

0114 

R 

DW 

LCONFLUSH 

7 

flush buff 

49 

001 0 

OOFA 

R 

DW 

CDNOUT 

8 

write 

SO 

0012 

OOFA 

R 

DW 

CONOUT 

9 

wr i t e/ ver 

81 

0014 

OOB5 

R 

DW 

RETURN 

10 

wr it e stat 

S2 

O01 6 

OOB5 

R 

DW 

RETURN 

1 1 

not used 

S3 

0018 

OOB5 

R 

DW 

RETURN 

12 

not used 

S4 








5S 

O01 A 

OOB5 

R 

CLKTBL: DW 

RETURN 

0 

not used 

S6 

001 C 

OOB5 

R 

DW 

RETURN 

1 

not used 

S7 

O01 E 

OOB5 

R 

DW 

RETURN 

2 

not used 

58 

0020 

OOAC 

R 

DW 

CMDERR 

3 

reserved 

59 

0022 

02AF 

R 

DW 

CETT IME 

4 

read 

80 

0024 

OOB6 

R 

DW 

BUSY 

5 

read non-d 

6 1 

0026 

00B5 

R 

DW 

RETURN 

6 

not used 

62 

0026 

OOB5 

R 

DW 

RETURN 

7 

not used 

83 

002A 

0296 

R 

DW 

SETTIME 

8 

write 

84 

O02C 

0296 

R 

DW 

SETTIME 

9 

wr i t e/ver 

85 

002E 

OOB5 

R 

DW 

RETURN 

10 

not used 

66 

0030 

OOB5 

R 

DW 

RETURN 

1 1 

not used 

67 

0032 

OOB5 

R 

DW 

RETURN 

1 2 

not used 

68 

0034 



XCOM TBL : 




69 

0034 

004E 

R 

DW 

CINIT 

0 

- Initialize Driver. 

70 

0036 

OOB5 

R 

DW 

RETURN 

1 

- Return current media code. 

7 1 

0038 

OOB5 

R 

DW 

RETURN 

2 

- Get Bios Parameter Block. 

72 

O03A 

0193 

R 

DW 

XC lOCTL 

3 

- lOCTL 

73 

O03C 

0146 

R 

DW 

XC“lN 

4 

- read. 

74 

003E 

01 6F 

R 

DW 

xc“"noin 

5 

- Non-d input 

75 

0040 

OOB5 

R 

DW 

RETURN 

6 

- Return status. (Not used) 

76 

0042 

OOB5 

R 

DW 

RETURN 

7 

- Flush input buffer. (Not used. 

77 

0044 

0159 

R 

DW 

XC OUT 

8 

- write. 

78 

004 6 

0159 

R 

DW 

XC OUT 

9 

- Block write with verify. 

79 

0048 

0138 

R 

DW 

XC OSTAT 

10 

- Return output status. 

80 

004A 

OOB5 

R 

DW 

RETURN 

1 1 

- Flush output buffer. (Not used 

8 1 

004C 

0193 

R 

DW 

XC lOCTL 

12 

- lOCTL 
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82 




83 




84 

004E 



85 

004E 

80 

3E 0137 R 01 

86 

0053 

75 

03 

87 

0055 

E9 

OOOO E 

88 

0058 

C3 


89 




90 




9 1 




92 




93 

0059 



94 

0059 

2E 

: C6 06 0137 R 

95 

005F 

EB 

OE 

96 

006 1 



97 

006 1 

2E 

: C6 06 0137 R 

98 

0067 

EB 

06 

99 

0069 



100 

0069 

2E 

: C6 06 0137 R 

101 

O06F 



102 

006F 

66 


103 

0070 

BE 

0034 R 

104 

0073 

EB 

OA 

105 




106 

0075 

56 


107 

0076 

BE 

001 A R 

108 

0079 

EB 

04 

109 




1 10 

007B 

56 


1 1 1 

007C 

BE 

OOOO R 

1 12 




1 13 




1 14 




1 15 




1 18 




1 17 




1 18 




1 19 

007F 



120 

007F 



121 

007F 

50 


122 

0080 

53 


123 

008 1 

51 


124 

0082 

52 


125 

0083 

57 


126 

0084 

IE 


127 

0085 

06 


128 




1 129 

0086 

2E 

: C5 IE OOOO E 

130 

008B 

C7 

47 03 0100 

131 

0090 

8B 

4F 12 

132 

0093 

C4 

7F OE 

133 

009 6 

8A 

47 02 

134 

0099 

98 


135 

009A 

03 

FO 

138 

009 C 

03 

FO 


02-20-84 


CMP 

JNZ 

JMP 

RET 


BYTE PTR XC__DEV , 1 
C I N I T 1 ” 

INITCOM 


check first t i me 
only init once 


10 device BIOS interface 


AUX : 
XCOMM: 


MOV 

JMP 


MOV 

JMP 


PUSH 

MOV 

JMP 

PUSH 

MOV 

JMP 

PUSH 

MOV 

JMP 


BYTE PTR CS:XC DEV, 3 
SHORT XCOMM 


BYTE PTR CS:XC DEV. 2 
SHORT XCOMM “ 


BYTE PTR CS : XC_OEV . 1 


SI, OFFSET XCOM TBL 
SHORT ENTER “ 


SI. OFFSET CLKTBL 
SHORT ENTER 


SI, OFFSET CONTBL 
SHORT ENTER 


device extended comm port 
device printer port 
device comm port 


Common command dispatch. Pick up useful things 
; and dispatch to the right routine within the table. 

ENTER : 

DISPATCH PROC FAR 
PUSH AX 

PUSH BX 

PUSH CX 

PUSH DX 

PUSH DI 

PUSH DS 

PUSH ES 


LDS BX . CS : PTRSAVE 

MOV WORD PTR [BX. STATUS] 

MOV CX. [BX . COUNT] 

LES DI . [BX . TRANS] 

MOV AL, [BX.CMD] 

CBW 
ADO 
ADD 


; get data pKt , 

100H ; set done bit 

; CX s count 

ES;DI s buffer addr 
; AL < command 
: make it word 
; add offset 


SI , AX 
SI , AX 
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1 37 

009E 

OE 




PUSH 

CS 

138 

009F 

1 F 




POP 

OS 

139 

OOAO 

FC 




CLO 


1 40 

OOA1 

FF 

1 4 



CALL 

WORD PTR (SI] 

1 4 1 

00A3 

07 




POP 

ES 

142 

OOA4 

IF 




POP 

OS 

143 

OOA5 

5F 




POP 

DI 

144 

OOA6 

5A 




POP 

OX 

145 

OOA7 

59 




POP 

CX 

146 

OOA8 

5B 




POP 

BX 

147 

OOA9 

58 




POP 

AX 

148 

OOAA 

5E 




POP 

SI 

1 49 

OOAB 

CB 




RET 


150 

OOAC 




OISPATCH ENOP 


151 








152 








153 






set command error . 

154 








155 

OOAC 

C5 

IE 

OOOO E 

CMOERR ; 

LOS 

BX , PTRSAVE 

156 

OOBO 

8 1 

4F 

03 8003 


OR 

WORD PTR ( BX . STATUS ], 80031 

1 57 

OOB5 

C3 



RETURN ; 

RET 


158 








1 59 








1 60 






Set BUSY. 

1 6 1 








162 

OOB6 

C5 

1 E 

OOOO E 

BUSY ; 

LOS 

BX , PTRSAVE 

1 63 

OOBA 

6 1 

4F 

03 0200 


OR 

WORD PTR ( BX . STATUS ], 200H 

1 64 

OOBF 

C3 




RET 



: CS 

forward direction 
form func 
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1 65 
166 

1 67 
1 66 

169 

170 OOCO 

171 OOCO 

172 00C3 

173 OOCS 

174 OOC7 

175 OOCS 

176 OOCC 

177 OOCE 

178 0001 

179 0005 

180 0006 

181 0008 

182 0006 

183 OOOF 

184 OOE2 

185 

186 

187 

188 OOE3 

189 OOE3 

190 00E6 

191 00E8 

192 OOEA 

193 OOEC 

194 

195 

196 

197 OOEO 

198 OOEO 

199 OOEE 

200 OOEF 

201 OOFO 

202 OOF3 

203 00F4 

204 OOFS 

205 OOF6 

206 OOF7 

207 OOF9 

208 
209 

2 10 

211 OOFA 

212 OOFA 

213 OOFB 

214 OOFC 

215 OOFE 

216 OOFE 

217 OOFF 

218 0100 

219 O101 


BF 0004 
CO 1 8 
22 C9 
74 EO 
B8 EEOO 
8E CO 
BE OFB8 
26; 8A 44 14 

98 

03 FO 
26; 8 A 04 

C5 3E OOOO E 
88 45 00 
C3 


BF 0004 
CO 1 8 
22 C9 
74 CA 
C3 


06 
57 
5 1 

E8 010A R 

59 

5F 

07 

AA 

E2 F4 
C3 


06 
1 F 

8B F7 

51 

56 

AC 

33 FF 


PACE 


Non destructive console read. If char is 
available, return it, else return busy set. 


CONI NXOR ; 

MOV 

INT 

ANO 

JZ 

MOV 

MOV 

MOV 

MOV 

CBW 

AOO 

MOV 

LOS 

MOV 

RET 


0 1,4 ; 

ROM 

CL , CL ; 

BUSY ; 

AX, OFFSET SYSRAM 
ES , AX 

SI, OFFSET ESCSTR+1 ; 

AL,ES;BYTE PTR ESCOFFiSIl 

S I , AX 

AL . ES ; (SI ] ; 

01,PTRSAVE ; 

(01 MEOIA] . AL ; 


Level 2 console status 

Check any char 
None - return busy 
set SYSRAM segment 

string addr 

; get string index 
make it word 

get char from buffer 
get pkt pt r , 
return it 


; console input status 

CONISTAT ; 

MOV 01,4 

INT ROM 

ANO CL, CL 

JZ BUSY 

RET 


; Level 2 console status 

; Check any char 
; None - return busy 


; console input 

CONI N : 

PUSH ES 

PUSH 01 

PUSH CX 

CALL LCONIN 

POP CX 

POP 01 

POP ES 

STOSB 

LOOP CONIN 

RET 

Write character(s) to the console. 

CONOUT ; 

PUSH ES 

POP OS 

MOV SI, 01 ; get pointer into DS:OI 

C0N0UT1 : 

PUSH CX 

PUSH SI 

LOOSB 
XOR 


DI , 01 


; get output char 
: do console output 
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220 

0103 

CD 

1 a 

INT 

ROM 

22 1 

0 1 05 

5E 


POP 

SI 

222 

0106 

59 


POP 

CX 

223 

0107 

E2 

FS 

LOOP 

C0N0UT1 

224 

0109 

C3 


RET 


225 






226 






227 




CONSOLE 

i nput , wait if 

228 






229 




EXIT : 

AL = character 

230 




USE ; 

ALL 

23 1 






232 

0 1 OA 


LCONIN : 


233 

0 10A 

BF 

0002 

MOV 

01,2 

234 

0100 

CO 

1 a 

INT 

ROM 

235 

010F 

22 

C9 

AND 

CL . CL 

236 

0 111 

74 

F7 

J2 

LCONIN 

237 

0 113 

C3 


RET 


238 






239 




Flush the console input 

240 






24 1 

0 114 


LCONFLUSH : 


242 

0 114 

BF 

0002 

MOV 

01.2 

243 

0 117 

CO 

1 a 

INT 

ROM 

244 

0 119 

22 

C9 

AND 

CL . CL 

245 

0 1 1 B 

75 

F7 

JNZ 

LCONFLUSH 

246 

0 110 

C3 


RET 


247 






248 






249 




Out put 

a character from 

250 






25 1 




USE : none 

252 






253 

01 IE 


LCONOUT ; 


254 

0 1 1 E 

50 


PUSH 

AX 

255 

O 1 1 F 

S3 


PUSH 

BX 

256 

0120 

5 1 


PUSH 

CX 

257 

012 1 

52 


PUSH 

OX 

258 

0122 

56 


PUSH 

SI 

259 

0 123 

57 


PUSH 

01 

260 

0 124 

55 


PUSH 

BP 

26 1 

0 125 

06 


PUSH 

ES 

262 

0 126 

33 

FF 

XOR 

01,01 

263 

O 1 28 

CD 

1 a 

INT 

ROM 

264 

0 1 2A 

07 


POP 

ES 

265 

01 2B 

50 


POP 

BP 

266 

01 2C 

5F 


POP 

01 

267 

0 120 

5E 


POP 

SI 

268 

O 1 2E 

5A 


POP 

OX 

269 

01 2F 

59 


POP 

CX 

270 

0130 

SB 


POP 

BX 

27 1 

0 13 1 

58 


POP 

AX 

272 

0132 

C3 


RET 



check status 
waft 


level 2 console in 


any character? 

Keep flush if still have character 
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275 

276 0133 

277 0133 E8 O 1 1 E R 

278 0136 CF 


CALL LCONOUT 

IRET 


02-20-84 


PAGE 


8-8 
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278 





280 





281 





282 





283 

0137 

00 



284 





286 





286 





287 

0138 




288 

0138 

8A 

2E 0137 

R 

289 

013C 

E8 

OOOO E 


290 

013P 

22 

CO 


291 

0141 

75 

15 


292 

0143 

E9 

008 6 R 


293 





294 





295 





298 

0146 




297 

0146 

57 



298 

0147 

51 



299 

0148 

06 



300 

0149 

8A 

2E 0137 

R 

301 

0140 

E8 

OOOO E 


302 

0150 

8A 

Cl 


303 

0152 

07 



304 

0153 

59 



305 

0154 

5F 



306 

0155 

AA 



307 

0156 

E2 

EE 


308 

0158 




309 

0158 

C3 



310 





3 1 1 





312 





313 

0159 




314 

0159 

26 

; 8A 05 


315 

015C 

47 



318 

015D 

57 



317 

015E 

06 



318 

01 5F 

5 1 



3 19 

0160 

8A 

DO 


320 

0162 

8A 

2E 0137 

R 

321 

0186 

E8 

OOOO E 


322 

0169 

59 



323 

01 6A 

07 



324 

0188 

5F 



325 

01 6C 

E2 

EB 


326 

01 6E 

C3 



327 





328 





329 





330 

01 6F 




331 

01 6F 

8A 

2E 0137 

R 

332 

0173 

E8 

0184 R 


333 

0176 

75 

09 



AUX, PRN, 8 AUX2 common routines 


XC DEV DB 


comm output status 


XC OSTAT: 


MOV 

CH.XC DEV 

; get device # 

CALL 

OUTSTAT 


AND 

AL , AL 

xmt ready? 

JNZ 

XC IN2 


JMP 

BUSY 


comm 

input character 


PUSH 

01 


PUSH 

CX 


PUSH 

ES 


MOV 

CH.XC OEV 

; get device # 

CALL 

GETCHAR 

go to get character 

MOV 

AL .CL 


POP 

ES 


POP 

CX 


POP 

01 


STOSB 


; save in buffer 

LOOP 

XC__IN 


RET 

comm 

output character 


MOV 

AL . ES : [ 01 ] 

get character 

INC 

01 


PUSH 

01 


PUSH 

ES 


PUSH 

CX 


MOV 

DL . AL 


MOV 

CH.XC DEV 


CALL 

PUTCHAR 


POP 

CX 


POP 

ES 


POP 

01 


LOOP 

RET 

XC OUT 



comm non destructive input 


MOV 

CALL 

JNZ 


CH , XC_OEV 
COM NDIN 
XC N0IN1 


get device # 
get i t 

check if any input 
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334 

0178 

C4 

3E OOOO 

E 

LES 

01 . PTRSAVE 

get packet pointer 

335 

017C 

26 

88 40 

00 

MOV 

BYTE PTR ES : 1 01 

.MEDIA]. CL ; save character in 

336 

0180 

C3 



RET 



337 

0181 




XC N01N1 ; 



338 

018 1 

E9 

0086 R 


“ JMP 

BUSY 


339 








340 








341 





Non- 

destructed input 


342 








343 

0184 




COM NDIN: 



344 

0184 

E8 

OOOO E 


“ CALL 

INSTAT 

check input status 

345 

0187 

3C 

FF 


CMP 

AL . OFFH 

any character? 

346 

0189 

75 

F8 


JNZ 

XC NDIN1 

; return if no 

347 

0188 

26 : 

; 88 77 

06 

MOV 

SiTeS : RBOUT[BX] 

get buffer address 

348 

018F 

26 : 

; 88 OC 


MOV 

CX.ES:0[SI] 

get character and status 

349 

0192 




COM NDIN1 : 



350 

0192 

C3 



RET 




packet 
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RAGE 


0-10 


3S1 










PACE 



352 








XC lOCP 

STRUC 



353 













354 

oooo 

00 






XC FUN 

DB 


0 ; f unct i on # 

355 

0001 

00 






xc“rc 

DB 


0 ; return code 

356 

0002 

00 






XC“CHAR 

DB 


0 character 

357 

0003 

00 






XC“STAT 

DB 


0 ; character status 

356 

0004 

OO 






xc”buf 

OB 


0 : CCB or buffer 

359 













360 

0005 







XCIOCP 

ENDS 



361 













362 










XC lOCTL 

363 













364 










ENTRY 


ES:DI * packet pointer 

365 













366 










byt e 

O 

* f unct i on # 

367 










byt e 

1 

s return code 

360 










byt e 

2 

« character 

369 










byt e 

3 

s character status 

370 










byt e 

4 

to byte n * buffer 

37 1 













372 

0193 







XC lOCT 

L : 



373 

0193 

6A 

2E 0137 

R 





MOV 


CH.XC^DEV ; CH * device # 

374 

0197 

BB 

0004 







MOV 


BX. OFFSET XC_BUF ; BX > buffer addre 

375 

01 9A 

03 

DF 







ADO 


BX.DI ; add packet offset 

376 

01 9C 

6C 

C2 







MOV 


DX.ES ; DX : segment 

377 













376 

01 9E 

26 : 

8A 

05 






MOV 


AL.ES:tOI] ; get function # 

379 

01A1 

96 








CBW 


: make it word 

360 

01 A2 

BE 

01 AB 

R 






MOV 


SI. OFFSET X10C_TBL ; get offset 

36 1 

01 A5 

03 

FO 







ADD 


SI. AX : add word offset 

382 

01 A7 

03 

FO 







ADO 


S I , AX 

383 

01 A9 

FF 

24 







JMP 


WORD PTR [SI] ; perform function 

364 













365 

01 AB 








(IOC TBL: 



386 

01 AB 

01 DF R 

01EC 

R 

01 EF 

R 



OW 


FUNO. FUN 1 . FUN2 , FUN3 

387 


01 F2 R 










368 

01B3 

01 FB R 

01 FE 

R 

0201 

R 



DW 


FUN4 . FUNS , FUNS 

389 

01 B9 

0206 R 

02 1 6 

R 

022 1 

R 



DW 


FUN7 , FUN6 , FUNS 

390 

01 BF 

0228 R 

0235 

R 

023C 

R 



DW 


FUN10, FUN1 1 , FUN12 

39 1 

01 C5 

0243 R 

024A 

R 

025 1 

R 



DW 


FUN 1 3 , FUN1 4 . FUN 1 5 

392 

01 CB 

0254 R 

0257 

R 

0260 

R 



DW 


FUN16.FUN17. FUN18 

393 

01D 1 

0263 R 

0260 

R 

0270 

R 



DW 


FUN 19 . FUN20. FUN21 

394 

01 D7 

0278 R 

027B 

R 

0260 

R 



DW 


FUN22 . FUN23 , FUN24 

395 

01 DD 

0283 R 







OW 


FUN2S 
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396 PAGE 

397 


398 

01DF 



FUNO : 


399 

01DF 

SB 

CB 


MOV 

400 

01E1 

06 



PUSH 

401 

01E2 

57 



PUSH 

402 

01E3 

E8 

OOOO E 


CALL 

403 

01E6 



FUN_RC : 


404 

01E6 

5F 



POP 

405 

01E7 

IF 



POP 

406 

01E8 

88 

45 01 


MOV 

407 

01EB 

C3 



RET 

408 






409 

01EC 



FUN1 : 


4 10 

01EC 

E9 

OOOO E 


JMP 

4 1 1 

01EF 



FUN2 : 


4 1 2 

01EF 

E9 

OOOO E 


JMP 

413 

01F2 



FUN3 : 


414 

01F2 

8B 

CB 


MOV 

415 

01F4 

06 



PUSH 

416 

01F5 

57 



PUSH 

417 

01F6 

E8 

OOOO E 


CALL 

418 

01F9 

EB 

EB 


JMP 

419 

O 1 FB 



FUN4 : 


420 

01FB 

E9 

OOOO E 


JMP 

42 1 

01FE 



FUN5 ; 


422 

01FE 

E9 

OOOO E 


JMP 

423 






424 

0201 



FUN6 : 


425 

0201 

06 



PUSH 

426 

0202 

57 



PUSH 

427 

0203 

E8 

OOOO E 


CALL 

428 

0206 

EB 

DE 


JMP 

429 

0208 



FUN7 : 


430 

0208 

06 



PUSH 

431 

0209 

57 



PUSH 

432 

O20A 

E8 

OOOO E 


CALL 

433 

020D 



FUN CHAR: 

434 

020D 

5F 



POP 

435 

020E 

IF 



POP 

436 

020F 

88 

45 01 


MOV 

437 

0212 

89 

4D 02 


MOV 

438 

0215 

C3 



RET 

439 

0216 



FUNS : 


440 

0216 

06 



PUSH 

441 

0217 

57 



PUSH 

442 

0218 

E8 

OOOO E 


CALL 

443 

02 IB 



FUN_AX : 


444 

02 IB 

5F 



POP 

445 

021C 

IF 



POP 

446 

021D 

89 

45 02 


MOV 

447 

0220 

C3 



RET 

448 

0221 



FUNS : 


449 

0221 

06 



PUSH 

450 

0222 

57 



PUSH 


CX . OX 
ES 
01 

PRG7201 

01 

DS 

I D I . XC__RC ] , AL ; return function code 


0FLT72O1 

DFLTBUF 

CX, OX 

ES 

01 

RDSETUP 
SHORT FUN_RC 

RCVENA 

RCVOIS 


ES 

01 

INSTAT 

SHORT FUN_RC 

ES 

DI 

INCHAR 

DI 

DS 

[ D I . XC_RC I , AL ; return function 

WORD PTR (DI .XC_CHARI .CX ; return char and 


ES 

DI 

GETCHAR 

DI 

OS 

WORD PTR (DI.XC CHAR], AX ; return char and 


ES 

DI 


code 

status 


status 
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45 1 

0223 

E8 

OOOO E 


CALL 

OUTSTAT 


452 

0226 

EB 

BE 


JMP 

SHORT FUN__RC 


453 

0228 



FUN10 : 




454 

0228 

26 

8A 55 02 


MOV 

DL , ES : [ DI . XC CHAR] 

; get char 

455 

022C 

06 



PUSH 

ES "" 


456 

022D 

57 



PUSH 

DI 


457 

022E 

E8 

OOOO E 


CALL 

OUTCHAR 


458 

023 1 

8A 

Cl 


MOV 

AL . CL 

; get return code 

459 

0233 

EB 

B1 


JMP 

SHORT FUN_RC 


460 

0235 



FUN 1 1 




46 1 

0235 

26 

8A 55 02 


MOV 

DL . ES : I DI . XC CHAR] 


462 

0239 

E9 

OOOO E 


JMP 

PUTCHAR 


463 

023C 



FUN1 2 




464 

023C 

26 

8A 55 02 


MOV 

DL . ES : [ DI . XC CHAR] 


465 

0240 

E9 

OOOO E 


JMP 

OUTNOW 


466 

0243 



FUN13 




467 

0243 

06 



PUSH 

ES 


468 

0244 

57 



PUSH 

DI 


469 

0245 

E8 

OOOO E 


CALL 

RDMOOEM 


470 

0248 

EB 

D 1 


JMP 

FUN_AX 


47 1 

024A 



FUN 1 4 




472 

024A 

06 



PUSH 

ES 


473 

024B 

57 



PUSH 

0 I 


474 

024C 

E8 

OOOO E 


CALL 

SETMODEM 


475 

024F 

EB 

95 


JMP 

SHORT FUN^RC 


476 

025 1 



FUN 1 5 




477 

0251 

E9 

OOOO E 


JMP 

BRKON 


478 

0254 



FUN 1 6 : 




479 

0254 

E9 

OOOO E 


JMP 

BRKOFF 


480 

0257 



FUN1 7 ; 




48 1 

0257 

8B 

CB 


MOV 

CX . BX 


482 

0259 

06 



PUSH 

ES 


483 

025A 

57 



PUSH 

01 


484 

025B 

E8 

OOOO E 


CALL 

RCVINT 


485 

025E 

EB 

86 


JMP 

SHORT FUN_RC 


486 

0260 



FUN 1 8 : 




487 

0260 

E9 

OOOO E 


JMP 

RCVCANCEL 


488 

0263 



FUN 1 9 




489 

0263 

8B 

CB 


MOV 

CX , BX 


490 

0265 

06 



PUSH 

ES 


49 1 

0266 

57 



PUSH 

0 I 


492 

0267 

E8 

OOOO E 


CALL 

XMTMTY 


493 

026A 

E9 

01 E6 R 


JMP 

FUN_RC 


494 

026D 



FUN20 




495 

026D 

E9 

OOOO E 


JMP 

XMTCANCEL 


496 

0270 



FUN2 1 




497 

0270 

8B 

CB 


MOV 

CX . BX 


498 

0272 

E8 

OOOO E 


CALL 

HACK7201 


499 

0275 

E9 

01 E6 R 


JMP 

FUN_RC 


500 

0278 



FUN22 




501 

0278 

E9 

OOOO E 


JMP 

VECT720 1 


502 

027B 



FUN23 




503 

027B 

8B 

CB 


MOV 

CX . BX 


504 

0270 

E9 

OOOO E 


JMP 

STATCHG 


505 

0280 



FUN24 





The Microsoft MACRO Assembler 02-20*84 PAGE 8-13 

Character 10 for HSDOS 2.00 


506 0280 E9 OOOO E JMP STCANCEL 

507 0283 FUN25: 

508 0283 06 PUSH ES 

509 0284 57 PUSH 01 

510 0285 E8 0184 R CALL COM_NDIN 

511 0288 EB 83 JMP FUN CHAR 
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5 1 2 



PAGE 

513 




5 1 4 



Time and Date Oata Area. 

515 



Initialized time and date. 

5 1 6 




517 



;««*»» don't change the order 

5 1 8 

028A 

0559 

OAYS OW 1 09 6-»^31'i-28-l-3 1-*-30 + 3 1+30-<>3 14-3 1-^30 ; Oct 1. 1983 

5 1 9 

028C 

OO 

MINUTES 09 0 

520 

028D 

OO 

HOURS 09 0 

52 1 

028E 

OO 

TICKS__H 09 0 ; high byte for 0.01 sec 

522 

028F 

OO 

SECONDS 09 O 

523 

0290 

OO 

TICKS_L 09 0 ; low byte for 0.01 sec 

524 



;««»«« don't change the order 

525 




526 

029 1 

3C 

TICKER 09 60 ;1/60 or 1/50 counter 

527 

0292 

3C 

CLK 60 50 09 60 ,60/50 Hz constant set by ioinit 

528 

0293 

01 AA 

CLK''1 6 20 DW 426 ; 1 / 60 . 0502 » 25 6 * 1 OO c 4 2 6 or 1/49.9465*256*1003512 

529 

0295 

FO 

CLK”aDJ 09 -3 ;( 60-60.052 )*60: -3 or ( 50 - 49 . 9 4 6 5 ) * 60 s 3 

530 




531 




532 



; SETTIME - set time 

533 




534 



: ENTRY: ES;DI : time source buffer 

535 




536 

0296 


SETTIME: 

537 

029 6 

BE 028A R 

MOV S I , OFFSET DAYS 

538 

0299 

1 E 

PUSH OS ; XCHC DS . ES 

539 

029A 

06 

PUSH ES 

540 

029B 

1 F 

POP DS 

54 1 

029C 

07 

POP ES 

542 

0290 

87 F7 

XCHG SI, 01 

543 

029F 


SETTIME 1 : 

544 

029F 

99 0003 

MOV CX,3 

545 

02A2 

F3/ AS 

REP MOVSW 

546 

02A4 

OE 

PUSH CS ;RESTORE DS : 

547 

02A5 

1 F 

POP DS 

548 

02A6 

8A OE 0292 R 

MOV CL, CLK 60 50 ; RESET COUNTER/ T I MER 

549 

02AA 

88 OE 0291 R 

MOV tickerTcl 

550 

02AE 

C3 

RET 

55 1 




552 



GETT IME - get t ime 

553 




554 



; ENTRY: ES : D I s time destination buffer 

555 




556 

02AF 


GETT IME : 

557 

02AF 

BE 028A R 

MOV S I , OFFSET DAYS 

558 

0292 

99 0003 

MOV CX,3 

559 

0295 

F3/ AS 

REP MOVSW 

560 

0297 

C3 

RET 

56 1 





The 

M i cr osof t 

MACRO 

Assembler 

02-20 

-84 

PAGE 8-15 



Character 10 for MSDOS 2.00 






562 

563 







PAGE 




564 

565 

566 

0298 





CLKISR : 

clock 

interrupt service. 

We have a 16.66 ms clock. 


567 

0298 

1 E 





PUSH 

DS 

DS : CS 


568 

0299 

OE 





PUSH 

CS 



569 

02BA 

1 F 





POP 

DS 



570 











571 







NOTE : 

the 60/50 ticKs/second constant(CLK 16 20) and 


572 







adjustment value (CLK ADJ } must be set by ioinit, default 

is 60 Hz . 

573 

574 

0299 

50 





PUSH 

AX 



575 

02BC 

S3 





PUSH 

BX 



576 

02BD 

8A 

26 

028E 

R 


MOV 

AH, TICKS H 

get ticks high byte 


577 

02C 1 

AO 

0290 R 



MOV 

AL , T I CKS_L 

get ticks low byte 


578 

02C4 

03 

06 

0293 

R 


ADD 

AX , CLK 16 20 

add constant for 0.01 sec 


579 

02C8 

88 

26 

028E 

R 


MOV 

TICKS H.AH 

save value 


580 

02CC 

A2 

0290 R 



MOV 

TICKS“l , AL 

save value 


581 











582 

02CF 

FE 

OE 

029 1 

R 


DEC 

TICKER 

count down ticker 


583 

0203 

75 

4E 




JNZ 

CLKRET 

t i me yet ? 


584 

0205 

AO 

OOOO E 



MOV 

AL . DSKTMR 

do disk timeout processing 


585 

0208 

FE 

C8 




DEC 

AL 



586 

02DA 

78 

03 




JS 

OV 

jump if timer already expired 


587 

02DC 

A2 

OOOO E 



MOV 

DSKTMR . AL 

set new value 


588 

02DF 

AO 

0292 R 


OV : 

MOV 

AL.CLK 60 50 

get 60/50 Hz constant 


589 

02E2 

A2 

029 1 R 



MOV 

TICKER, AL 

reset the t icker 


590 

02E5 

98 

0O3C 



MOV 

AX , 60 

AH:0, AL:60 used as constant 


59 1 

02E8 

88 

26 

028E 

R 


MOV 

TICKS_H , AH 

reset 0.01 sec count to o 


592 











593 

02EC 

FE 

06 

028F 

R 


INC 

SECONDS 



594 

02FO 

38 

06 

028F 

R 


CMP 

SECONDS . AL 

AL =60 


595 

02F4 

72 

20 




JB 

CLKRET 



596 

02F6 

88 

26 

028F 

R 


MOV 

SECONDS , AH 

SECONDS =0 


597 

02FA 

8A 

IE 

0295 

R 


MOV 

BL , CLK ADJ 

get adjust value 


598 

02FE 

28 

1 E 

029 1 

R 


SUB 

TICKER. BL 

adjust ticker every minute 


599 

0302 

FE 

06 

028C 

R 


INC 

MINUTES 



600 

0306 

38 

06 

028C 

R 


CMP 

MINUTES . AL 

AL =60 


601 

030A 

72 

1 7 




JB 

CLKRET 



602 

030C 

88 

26 

028C 

R 


MOV 

MINUTES , AH 

MINUTESiO 


603 

0310 

FE 

06 

0280 

R 


INC 

HOURS 



604 

0314 

80 

3E 

0280 

R 18 


CMP 

HOURS . 24 



605 

0319 

72 

08 




JB 

CLKRET 



606 

0319 

88 

26 

0280 

R 


MOV 

HOURS. AH 

; HOURSsO 


607 

031 F 

FF 

06 

028A 

R 


INC 

OAYS 



608 

0323 





CLKRET : 





r^09 

0323 

CD 

64 




INT 

PROFILE 

for user interface 


> 6 1 O 

0325 

SB 





POP 

BX 



61 1 

0326 

58 





POP 

AX 



612 

0327 

IF 





POP 

DS 



613 

0328 

CF 




INTRET : 

IRET 
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614 





PAGE 


615 







616 




; 

type 

bx as hex. followed by a space. 

617 







6 1 6 

0329 

8A 

C7 

out hex 

: mov 

al.bh ; most first 

6 1 9 

0326 

E8 

0339 R 


ca 1 1 

out 2 

620 

032E 

8A 

C3 


mov 

al.bl ; do least 

621 

0330 

E8 

0339 R 


call 

out 2 

622 

0333 

60 

20 


mov 

a1 . ' ' 

623 

0335 

E8 

01 IE R 


call 

Iconout 

624 

0338 

C3 



rot 


625 







626 





type 

a1 as hex. 

627 







628 

0339 

50 


out 2 : 

push 

ax 

629 

033A 

51 



push 

cx 

630 

0336 

61 

04 


mov 

C 1 , 4 

631 

0330 

02 

E8 


shr 

a 1 . c 1 

632 

033F 

59 



pop 

cx 

633 

0340 

E8 

0344 R 


ca 1 1 

out 1 h 

634 

0343 

58 



pop 

ax 

635 







636 




; 

type 

1 snybbi e of a 1 . 

637 







638 

0344 

24 

OF 

out 1 h : 

and 

al.Ofh ;on1y Is 4 bits 

639 

0346 

OC 

30 


or 

a 1 , ' 0 ' ; make asc 1 i 

640 

0348 

3C 

3A 


cmp 

a1 . '9 ' + 1 

64 1 

034A 

72 

02 


jb 

out 1 

642 

034C 

04 

27 


add 

al , 'a' - '9 ' - 1 ; 0-9 ,a1 -f 

643 

034E 

E8 

01 1 E R 

out 1 : 

call 

Iconout 

644 

035 1 

C3 


ohr : 

ret 


645 







646 




; 

Type 

a null terminated string. 

647 







648 

0352 

2E 

; 8A 07 

pst r : 

mov 

a 1 , cs : ( bx ] 

649 

0355 

43 



i nc 

bx 

650 

0356 

3C 

00 


cmp 

a 1 . 0 

65 1 

0358 

74 

F7 


j« 

ohr 

652 

035A 

E8 

01 1 E R 


cal 1 

Iconout 

653 

0350 

E8 

F3 


jmp 

pstr 

654 







655 

035F 



COOE 

ENDS 


656 





END 
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Macros : 





Name 

Lengt h 




CALRET 

O0O1 




SEO 

0002 




TA6LE 

0002 




Structures and records: 





Name 

Width 

# fields 




Shi ft 

Width 

Mask 

I n 1 1 1 a 1 

lODATA 

0016 

0009 



CMDUEN 

0000 




UNIT 

0001 




CMO 

0002 




STATUS 

0003 




MEDIA 

OOOD 




TRANS 

OOOE 




COUNT 

0012 




START 

0014 




XCIOCP 

0005 

0005 



XC FUN 

OOOO 




XC RC 

0001 




XC CHAR 

0002 




XC STAT 

0003 




XC 6UF 

0004 




Segments and groups: 





Name 

S 1 ze 

align 

combi ne 

c lass 

1 CGROUP 

GROUP 




CODE 

035F 

8YTE 

PURL IC 

'CODE' 

Symbo 1 s : 





Name 

Type 

Value 

Attr 


A7201 

Number 

0040 



A6AUD 

Number 

OOOE 



AMODEM 

Number 

0002 



APPXOF 

Allas 

8IT7 



AS7201 

Number 

0042 



ASCSU6 

Number 

001 A 



AUX 

L NEAR 

0069 

CODE 

Global 

AUX2 

L NEAR 

0059 

COOE 

Global « 

AUXDP 

Number 

0040 


1 

AUXP 

Number 

0042 



AUX PRN 

Number 

0044 



67201 

Number 

0041 



6AKGRN0 

Number 

24AF 



6AU0MAX 

Number 

001 1 



66AUD 

Number 

0006 



8 I TO 

Number 

0001 
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BIT1 Numbor 0002 

B1T2 Numbor 0004 

BITS Numbor 0004 

BIT4 Numbor 0010 

BITS Numbor 0020 

BITS Numbor 0040 

BIT7 Numbor 0040 

BMODEM Numbor OOFF 

BRKERR Alias BIT7 

BRKOFF L NEAR OOOO CODE Extornal 

BRKON L NEAR OOOO CODE Extornal 

BS7201 Numbor 0043 

BUSY L NEAR OOB6 CODE 

CBOATB Numbor 0003 

CBLEN Numbor 0011 

CBMODE Numbor OOO 1 

CBPORT Numbor OOOO 

CBPRTY Numbor 0004 

CBRADR Numbor OOOO 

CBRCVB Numbor 0005 

CBRXOF Numbor 0009 

CBSI2E Numbor OOOB 

CBSTART L BYTE OOOO CODE 

CBSTPB Numbor 0002 

CBTXB Numbor 0006 

CBTXOF Numbor OOOA 

CBXOFF Number 0004 

CBXON Numbor 0007 

CINIT L NEAR 004E CODE 

CINIT1 L NEAR 0054 CODE 

CLK L NEAR 0075 CODE Global 

CLK14X Number 0040 

CLKISR L NEAR 0244 CODE Global 

CLKRET L NEAR 0323 CODE 

CLKTBL L NEAR 00 1 A CODE 

CLK_16_20 L WORD 0293 CODE Global 

CLK_40_50 L BYTE 0292 CODE Global 

CLK_ADJ L BYTE 0295 CODE Global 

CLK_INT Number 002C 

CMOERR L NEAR OOAC CODE 

COMDMA Numbor 0043 

COM_NDIN L NEAR 0144 CODE 

C0M_NDIN1 L NEAR 0192 CODE 

CDN L NEAR 007B CODE Global 

CONIN L NEAR OOED CODE 

CONINXDR L NEAR OOCO CODE 

CONISTAT L NEAR OOE3 CODE 

CONOUT L NEAR OOFA CODE 

C0N0UT1 L NEAR OOFE CODE 

CONTBL L NEAR OOOO CODE 

CR1 Number OOOl 

CR17201 Number 0015 

CR1TXBE Number 0002 

CR2 Number 0002 

CR27201 Number O0 1 0 
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CR3 

Number 

0003 



CR4 

Number 

0004 



CR5 

Number 

0005 



CTS 

Alias 

B1T3 



DATMAX 

Number 

0006 



DAYS 

L WORD 

02SA 

CODE 


DC 1 

Number 

0O1 1 



DC3 

Number 

0013 



DEVCOM 

Number 

OOOl 



DEVMAX 

Numbor 

0003 



DEVPRT 

Number 

0002 



DEVXCOM 

Numbor 

0003 



DFLT7201 

L NEAR 

OOOO 

CODE 

Ext or na 1 

DFLTBUF 

L NEAR 

OOOO 

CODE 

Ext or na 1 

DISPATCH 

F PROC 

0O7F 

CODE 

Length :002D 

DSKIO 

Number 

0065 



DSKTMR 

V BYTE 

OOOO 

CODE 

Ext er na 1 

DSR 

Alias 

BIT2 



DTR 

Alias 

BIT2 



ENDTXBE 

Number 

0024 



ENTER 

L NEAR 

007F 

CODE 


E0I72O1 

Number 

0034 



ERR7201 

Number 

0030 



ESCOFF 

Number 

0014 



ESCSTR 

Number 

OFB7 



EXCOM 

Number 

0045 



FASTCON 

L NEAR 

0133 

CODE 

Globa 1 

FRHERR 

Alias 

BITS 



FUNO 

L NEAR 

01DF 

CODE 


FUN1 

L NEAR 

01EC 

CODE 


FUN10 

L NEAR 

0224 

CODE 


FUN 11 

L NEAR 

0235 

CODE 


FUN 12 

L NEAR 

023C 

CODE 


FUN13 

L NEAR 

0243 

CODE 


FUN14 

L NEAR 

024A 

CODE 


FUNIS 

L NEAR 

025 1 

CODE 


FUN1 5 

L NEAR 

0254 

CODE 


FUN17 

L NEAR 

0257 

CODE 


FUN 14 

L NEAR 

0260 

CODE 


FUN19 

L NEAR 

0263 

CODE 


FUN2 

L NEAR 

01EF 

CODE 


FUN20 

L NEAR 

026D 

CODE 


FUN21 

L NEAR 

0270 

CODE 


FUN22 

L NEAR 

0274 

CODE 


FUN23 

L NEAR 

027B 

CODE 


FUN24 

L NEAR 

0240 

CODE 


FUN25 

L NEAR 

0243 

CODE 


FUN3 

L NEAR 

01F2 

CODE 


FUN4 

L NEAR 

01FB 

CODE 


FUNS 

L NEAR 

01FE 

CODE 


FUNS 

L NEAR 

0201 

CODE 


FUN7 

L NEAR 

0204 

CODE 


FUNS 

L NEAR 

0216 

CODE 


FUNS 

L NEAR 

0221 

CODE 


FUN AX 

L NEAR 

021B 

CODE 
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PACE 


Symbol S' 4 


FUN_CHAR L NEAR 0200 CODE 

PUN_RC L NEAR 01E6 COOE 

CETCHAR L NEAR OOOO CODE Extornal 

GETTIME L NEAR 02AF CODE 

HACK7201 L NEAR OOOO CODE Extornal 

HOURS L BYTE 0280 COOE 

INCHAR L NEAR OOOO COOE Extornal 

INITCOM L NEAR OOOO COOE External 

INSTAT L NEAR OOOO COOE External 

INTRET L NEAR 0328 COOE Global 

KOP Number 0010 

RSP Number O0 1 1 

LCONFLUSH L NEAR 0114 COOE 

LCONIN L NEAR 010A COOE 

LCONOUT L NEAR 011E COOE 

MINUTES L BYTE 028C COOE 

MOOEMAX Number 0002 

OHR L NEAR 0351 COOE 

0UT1 L NEAR 034E COOE 

0UT1H L NEAR 0344 COOE 

0UT2 L NEAR 0339 COOE 

OUTCHAR L NEAR OOOO COOE External 

OUTHEX L NEAR 0329 COOE Global 

OUTNOW L NEAR OOOO COOE External 

OUTSTAT L NEAR OOOO COOE External 

OV L NEAR 020F COOE 

OVRERR Alias BITS 

PARERR Alias BIT4 

PC7201 Number 00 1 O 

PCBAUO Number 0008 

PCCR1 Number OOOB 

PCCR2 Number OOOC 

PCCR3 Number OOOO 

PCCR4 Number OOOE 

PCCR5 Number OOOF 

PCDATB Number 0029 

PCDFLT Number 0004 

PCFAIL Number 0026 

PCFLAG Number 0014 

PCIO Number OOOO 

PCLEN Number 0037 

PCMASK Number 0015 

PCMOOE Number 0027 

PCMOOM Number 0006 

PCPRTY Number 002A 

PCRAOR Number 0033 

PCRATE Number OOOA 

PCRCVA Number 0018 

PCRCVB Number 002B 

PCRCVF Number 0017 

PCRXOF Number 002F 

PCS7201 Number 00 12 

PCSIZE Number 0031 

PCSTART L BYTE OOOO CODE 

PCSTAT Number 0003 
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PCSTCA 

Number 

0022 



PCSTCF 

Number 

002 1 



PCSTPB 

Number 

0028 



PCTXB 

Number 

002C 



PCTXOF 

Number 

0030 



PCXMTA 

Number 

001 D 



PCXMTF 

Number 

001 C 



PCXOFF 

Number 

002E 



PCXON 

Number 

002D 



PRG7201 

L NEAR 

OOOO 

CODE 

Ext er na 1 

PRN 

L NEAR 

006 1 

CODE 

Globa 1 

PRNOP 

Number 

004 1 



PRNP 

Number 

0043 



PROFI LE 

Number 

0064 



PRTYMAX 

Number 

0003 



PSTR 

L NEAR 

0352 

CODE 

Globa 1 

PTRSAVE 

V DWORD 

OOOO 

CODE 

Exter na 1 

PUTCHAR 

L NEAR 

OOOO 

COOE 

Exter na 1 

RECOUNT 

Number 

OOOO 



RBDFLT 

Number 

0020 



RBHEAD 

Number 

OOOC 



RBIN 

Number 

0004 



RBLEN 

Number 

00 10 



RBMAX 

Number 

0002 



RBOUT 

Number 

0006 



RESTART 

L BYTE 

OOOO 

CODE 


RETAIL 

Number 

OOOE 



RBXOFF 

Number 

0008 



RBXON 

Number 

OOOA 



RCVBRK 

Alias 

BITO 



RCVCANCEL 

L NEAR 

OOOO 

CODE 

Externa 1 

RCVDIS 

L NEAR 

OOOO 

CODE 

Externa 1 

RCVENA 

L NEAR 

OOOO 

CODE 

External 

RCVINT 

L NEAR 

OOOO 

CODE 

Ext er na 1 

RCVOFF 

Alias 

BIT5 



RCVXOF 

Alias 

BITE 



RDMODEM 

L NEAR 

OOOO 

CODE 

Ext er na 1 

RDSETUP 

L NEAR 

OOOO 

CODE 

Externa 1 

RETURN 

L NEAR 

OOB5 

CODE 


RI 

Alias 

B I TO 



RLSD . . . . ’ 

Alias 

BIT4 



ROM 

Number 

0018 



RST7201 

Number 

0018 



RTS 

Alias 

BIT3 



RUPT7201 

L NEAR 

OOOO 

COOE 

Externa 1 

SECONDS 

L BYTE 

028F 

CODE 


SETMODEM 

L NEAR 

OOOO 

CODE 

Externa 1 

SETTIME 

L NEAR 

0296 

CODE 


SETT I ME 1 

L NEAR 

029F 

CODE 


SPARE4 1 

Number 

004 1 



SPARE42 

Number 

0042 



SPDI 

A1 ias 

BIT 1 



SPSEL 

A1 ias 

BITO 



SRI 

Number 

OOO 1 



SR2 

Number 

0002 
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SR3 

Number 

0003 



SRLSD 

Alias 

BIT1 



SRTS 

Alias 

BIT1 



STATCHG 

L NEAR 

oooo 

CODE 

Ext er na 1 

STCANCEL 

L NEAR 

oooo 

CODE 

Ext er na 1 

STPBMAX 

Number 

0003 



STRATEGY 

L NEAR 

oooo 

CODE 

Ext er na 1 

STRINX 

Number 

OFCC 



SX7201 

Number 

OO 10 



SYSRAM 

Number 

EEOO 



▼ICKER 

L BYTE 

029 1 

CODE 

Global 

TICKS H 

L BYTE 

028E 

CODE 


TICKS L 

L BYTE 

0290 

CODE 


UART 

Number 

0046 



VECT7201 

L NEAR 

OOOO 

CODE 

Ext er na 1 

VERT 

Number 

0040 



WPRSNT 

Number 

OOO 1 



XA7201 

Number 

0028 



XABAUO 

Number 

002 1 



XAMOOEM 

Number 

OOFF 



XAS7201 

Number 

002A 



XB7201 

Number 

0029 



XBMODEM 

Number 

0002 



XBS7201 

Number 

O02B 



XCOMM 

L NEAR 

006F 

CODE 


XCOM TBL 

L NEAR 

0034 

CODE 


XCPRSNT 

Number 

0002 



XC OEV 

L BYTE 

O 1 37 

CODE 


1 XC~I N 

L NEAR 

0146 

CODE 


XC IN2 

L NEAR 

0158 

CODE 


XC”lOCTL 

L NEAR 

0 193 

CODE 


xc“ndin 

L NEAR 

01 6F 

CODE 


XC NDIN1 

L NEAR 

018 1 

CODE 


XC”0STAT 

L NEAR 

0138 

CODE 


XC"“0UT 

L NEAR 

0 1 59 

CODE 


XIOC TBL 

L NEAR 

01 AB 

CODE 


XMTBRK 

Alias 

B I T3 



XMTCANCEL 

L NEAR 

OOOO 

CODE 

Ext er na 1 

XMTMTY 

L NEAR 

OOOO 

CODE 

Ext er na 1 

XMTXOF 

Alias 

BIT2 



XMTXON 

Alias 

BI T 1 



280 

Number 

0047 



?N 

Number 

0010 



Warning Severe 
Errors Errors 
O o 
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Symbol Cross 

Refer ence 


( # i s def 

init i 

ion) 

Cr ef - 

1 









?N 


3 1# 

3 1 

3 1# 

3 1 

31# 

3 1 

3 1 # 

3 1 

31# 

3 1 

31# 

3 1 

31# 

31 



3 1# 

3 1 

3 1 # 

3 1 

3 1 # 

3 1 

3 1 # 

31 

3 1# 

3 1 

3 1 # 

3 1 

3 1# 

31 



3 1# 

3 1 

3 1 

31# 

3 1 

3 1# 

3 1 

3 1 # 

3 1 

31# 

3 1 

31# 

3 1 

31# 



3 1 

3 1 # 

3 1 

3 1 # 

3 1 

3 1 # 

3 1 

3 1 # 

3 1 

3 1# 

3 1 

3 1# 

3 1 

31# 



3 1 

3 1# 

3 1 

3 1 # 

3 1 

3 1# 

3 1 

31# 

3 1 

31# 

3 1 

31# 

3 1 

3 1 # 



3 1 

3 1# 

3 1 

3 1 # 

3 1 

3 1# 

3 1 

3 1 # 

3 1 

3 1 # 

3 1 

3 1# 

3 1 

3 1 # 



3 1 

3 1 # 

3 1 

3 1 # 

3 1 

3 1# 

3 1 

3 1 # 

3 1 

31# 

3 1 

3 1# 

3 1 

3 1 # 



3 1 

3 1 # 

3 1 

3 1 # 

3 1 # 

3 1 

3 1 # 

3 1 

3 1# 

3 1 

3 1 # 

3 1 

3 1# 

31 



3 1# 

3 1 

3 1 # 

3 1 

3 1 # 

3 1 

3 1 # 

3 1 

3 1# 

31 





A7201 


3 1# 














ABAUO 


31# 














AMODEM ... 


3 1# 














APPXOF ... 


3 1# 














AS7201 ... 


3 1# 














ASCSUB ... 


31# 














AUX 


1 5 

99# 













AUX2 


1 5 

93# 













AUXDP 


31# 














AUXP 


3 1 # 














AUX_PRN. . . 


3 1# 














B7201 .... 


3 1# 














BAKGRND. . . 


3 1# 














BAUDMAX. . . 


3 1# 














BBAUD. . . . 


3 1# 














BITO .... 


3 1# 

3 1 

3 1 

3 1 











BIT 1 . . . . 


3 1# 

3 1 

3 1 

3 1 

3 1 










BIT2 .... 


3 1# 

3 1 

3 1 

3 1 











EIT3 .... 


3 1# 

3 1 

3 1 












BIT4 ... 


3 1 # 

3 1 

31 












BIT5 .... 


3 1# 

3 1 

3 1 












BIT6 .... 


31# 

3 1 

3 1 












BIT7 .... 


3 1# 

3 1 













BMOOEM . . . 


31# 














BRKERR . . . 


3 1# 














BRKOFF . . . 


24# 

479 













BRKON. . . . 


24# 

477 













BS7201 . . . 


3 1# 














BUSY .... 


60 

1 62# 

174 

192 

292 

338 









CBDATB . . . 


31# 














CBLEN. . . . 


3 1# 














CBMODE . . . 


31# 














CBPORT . . . 


31# 














CBPRTY . . . 


3 1# 














CBRADR . . . 


31# 














CBRCVB . . . 


3 1# 














CBRXOF . . . 


31# 














CBSIZE . . . 


3 1# 














CBSTART. . . 


31# 














CBSTPB . . . 


3 1# 














CBTXB. . . . 


31# 














CBTXOF . . . 


31# 














CBXOFF . . . 


31# 














CBXON. . . . 

CGROUP . . . 


31# 
1 1 

1 3 

13 

1 3 
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C# is daf init ion) 


CINIT 89 84# 

CINITl 86 88# 

CLK 15 106# 

CLK18X 31# 

CLKISR 16 568# 

CLKRET 583 595 601 605 

CLKTBL 55# 107 

CLK_16_20 16 528# 578 

CLK_80_60 16 527# 548 588 

CLK^AOJ 16 529# 597 

CLK_mT 31# 

CMD 31# 133 

CMDERR 44 58 158# 

CMDLEN 31# 

CODE 11 12# 12 655 

COMDMA 31# 

COM_NDIN 332 343# 510 

C0M_N0IN1 349# 

COnT 15 110# 

CONIN 45 197# 208 

CONINXDR 46 170# 

CONISTAT 47 188# 

CONOUT 49 50 21 1# 

C0N0UT1 215# 223 

CONTBL 41# 111 

COUNT 31# 131 

CR1 31# 

CR17201 31# 

CR1TXBE 31# 

CR2 31# 

CR27201 31# 

CR3. 31# 

CR4 31# 

CR5 31# 

CTS 31# 

DATMAX 3 1# 

days 518# 537 557 807 

DC1 31# 

DC3 31# 

DEVCOM 31# 

DEVMAX 31# 

DEVPRT 31# 

DEVXCOM 31# 

DFLT7201 20# 410 

OFLTBUF 20# 412 

DISPATCH 120# 150 

DSKIO 31# 

DSKTMR 30# 584 587 

DSR 31# 

DTR 31# 

ENDTXBE 31# 

ENTER 104 108 1 19# 

E0I72O1 31# 

ERR7201 31# 

ESCOFF 36# 178 
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C # is definition) 


ESCSTR . 
EXCOM. . 

FASTCON . 
FRMERR . 
FUNO . . 

FUN1 . . 

FUN10. . 
FUN1 1 . . 

FUN12. . 
FUN13. . 
FUN14. . 
FUNIS. . 
FUN16. . 
FUN 1 7 . . 

FUN18. . 
FUN19. . 
FUN2 . . 

FUN20. 
FUN2 1 . . 

FUN22. . 
FUN23. . 
FUN24 . . 

FUN25. . 
FUNS . . 

FUN4 . . 

FUNS . . 

FUN6 . . 

FUN7 . . 

FUNS . . 

FUNS . . 

FUN__AX . 
FUN__CHAR 
FUN_RC . 

GETCHAR . 
CETTIME . 


HACK7201 
HOURS. . 


INCHAR 

INITCOM 

INSTAT 

INTRET 

lODATA 

KDP . . 

KSP . . 


LCONFLUSH 
LCONIN . 
LCONOUT . 


34# 

36 

31# 

17 

276# 

3 1# 

386 

398# 

386 

409# 

390 

453# 

390 

460# 

390 

463# 

39 1 

466# 

39 1 

47 1# 

39 1 

478# 

392 

478# 

392 

480# 

392 

486# 

393 

488# 

386 

411# 

393 

494# 

393 

496# 

394 

500# 

394 

502# 

394 

505# 

395 

507# 

386 

4 1 3# 

388 

4 1 9# 

388 

42 1# 

388 

424# 

389 

429# 

389 

439# 

389 

448# 

443# 

470 

433# 

5 1 1 

403# 

4 1 8 

22# 

301 

59 

556# 

26# 

498 

520# 

803 

21# 

432 

19# 

87 

21# 

344 

1 6 

6 1 3# 

31# 

3 1 

31# 

31# 

48 

24 1# 

201 

232# 

253# 

277 


428 452 

442 

604 606 

427 


245 

236 

623 643 


MEDIA . 

MINUTES 

MOOEMAX 


31# 183 335 

519# 599 800 602 

31# 


Cref *2 


608# 


Cref “3 


459 475 485 493 499 


652 
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(# fs daffnitton) Craf~4 


OHR 844# 661 

0UT1 641 643# 

0UT1H 833 636# 

0UT2 619 621 626# 

OUTCHAR 22# 467 

0UTH6X 17 616# 

OUTNOW 23# 466 

OUTSTAT 22# 266 461 

OV 566 686# 

0VR6RR 31# 

PARERR 31# 

PC7201 31# 

PCBAUD 31# 

PCCR1 31# 

PCCR2 31# 

PCCR3 31# 

PCCR4 31# 

PCCR6 31# 

PCDAT6 31# 

PCOFLT 31# 

PCFAIL 31# 

PCFLAC 31# 

PCID 31# 

PCLEN 31# 

PCMASK 31# 

PCHOOE 31# 

PCMODM 31# 

PCPRTY 31# 

PCRADR 31# 

PCRATE 31# 

PCRCVA 31# 

PCRCVB 31# 

PCRCVF 3 1# 

PCRXOF 31# 

PCS7201 31# 

PCSIZE 31# 

PCSTART 31# 

PCSTAT 31# 

PCSTCA 31# 

PCSTCF 31# 

PCSTPB 31# 

PCTX6 31# 

PCTXOF 31# 

PCXMTA 31# 

PCXMTF 31# 

PCXOFF 31# 

PCXON 31# 

PRG7201 20# 402 

PRN 15 96# 

PRNDP 31# 

PRNP 31# 

PROFILE 31# 609 

PRTYMAX 31# 

PSTR 17 646# 653 

PTRSAVE 29# 129 155 162 182 334 


Charactar 10 for MSOOS 2.00 
Symbol Cross Rafarance 


(# is definition) Cref>5 


PUTCHAR 


23# 321 462 


R6C0UNT . 
RBDFLT . 
RBHEAO . 
RBIN . . 

RBLEN. . 
RBMAX . . 

RBOUT. . 
RBSTART . 
RBTAIL . 
RBXOFF . 
RBXON. . 
RCVBRK . 
RCVCANCEL 
RCVOIS . 
RCVENA . 
RCVINT . 
RCVOFF . 
RCVXOF . 
RDMODEM. 
RDSETUP . 
RETURN . 


31# 

31# 

3 1 # 

31# 

31# 

31# 

31# 347 

31# 

3 1 # 

31# 

31# 

31# 

25# 487 

21# 422 

21# 420 

26# 484 

31# 

31# 

23# 469 

20# 417 

4 1 42 

70 71 


43 

75 


51 

76 


52 53 55 56 57 

80 157# 


6 1 


62 65 66 


67 


RI . . . 
RLSO . . 
ROM. . . 
RST7201 . 
RTS. 

RUPT7201 


31# 

3 1# 

31# 172 190 220 234 243 263 

3 1 # 

31# 

19 # 


SECONOS 
SEP. . 


522# 593 

31 31 

31 31 

31 31 

31 31 

31 31 


594 596 

31 31 

31 31 

31 31 

31 31 


31 31 

31 31 

31 31 

3 1 31 


31 31 

31 31 

3 1 3 1 

31 31 


3 1 3 1 

3 1 3 1 

31 31 

31 31 


31 31 

31 31 

31 31 

3 1 3 1 


31 31 

31 31 

31 3 1 

31 31 


SETMOOEM 24# 474 

SETTIME 63 64 536# 

SETTIME1 543# 

SPARE41 31# 

SPARE42 31# 

SPDI 31# 

SPSEL 31# 

X SRI 31# 

SR2 31# 

SR3 31# 

^ SRLSD 31# 

SRTS 31# 

START 31# 

STATCHG 27# 504 

STATUS 31# 130 156 163 

STCANCEL 27# 506 

STPBMAX 3 1# 

STRATEGY 29# 



Ctiar«ct«r 10 for MSDOS 2.00 


Symbol Cross Soforonco 

STRINX 

SX7201 

SYSRAM 

TABLE 

TICKER 

TICKS H 

ticks'll 

trarsT 

UART 

UNIT 

VECT7201 

VERT 

WRRSNT 

XA7201 

XABAUD . 

XAMODEM 

XAS7201 

XB7201 

XBHODEM 

XBS7201 

XCIOCR ......... 

XCOMM 

XCOH TBL 

XCPRSNT 

XC BUF 

XC'^CHAR 

XC“OEV 

xc""fun 

XC”lN 

XC”lN2 

XC lOCTL 

xc”ndin 

XC^NDINI 

XC““0STAT 

XC“0UT 

XC RC 

XC^STAT 

XIOC TBL 

XMTBRK 

XMTCANCEL 

XMTMTY 

XMTXOF 

XMTXON 

Z80 


(# f s dof f nft ion) 


35# 

38 


31# 



33# 

175 


31 

31 

31 

16 

526# 

649 

521# 

576 

579 

523# 

577 

560 

31# 

132 


31# 

31# 



26# 

501 



31# 

31# 
31# 
3 1# 
3 1# 
31# 
31# 
31# 
352# 
95 
65 # 
31# 
356# 
356# 
65 

354# 

73 
29 1 

72 

74 
333 

79 

77 

355# 
357# 
360 
3 1# 
26# 
25# 
3 1# 
3 1# 


562 

591 


360 

96 

103 

374 

437 

94 

296# 
306# 
8 1 

330# 

337# 

287# 

76 

406 

365# 

495 

492 


446 

97 


3 1 3# 
436 


454 
1 00 


461 

283# 


464 

266 
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1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
1 1 
1 2 
1 3 
1 4 
1 5 
1 6 
17 
16 

19 

20 
21 

22 OOOO 

23 

24 

25 


PAGE . 132 

TITLE COMTAB 

SUBTTL TABLES 6 CONTROL BLOCKS FOR COMM PORTION OF VERSION 2 BIOS 


COMPANY CONFIOENTIAL 

Copyright (C) 1962, 1963 Digital Equipment Corporation 

All rights reserved. 


COMBIOS . A86 


version /V00-01/ 


APRIL 11, 1963 DEVELOPMENT 


vers 


on 


/VOO-02/ 

Change default 
port to be the 


JUN 02, 1983 

values for optional comm 
same as comm port . 


SECT COOE_SEG,REL 

CGROUP GROUP CODE 

CODE SEGMENT BYTE PUBLIC 'CODE' 

ASSUME CS;CGROUP, OS : CGROUP . ES : CGROUP , SS : CGROUP 


NL 1ST 



Th« Microsoft MACRO Assoisblor 
COMTAB 


02-20-B4 


RAGE 


B- 1 


TABLES « CONTROL BLOCKS FOR COMM PORTION OF VERSION 2 BIOS 


do not list macro expansion 


DFLTCOM 

OFLTFRT 

DFLTXCOM 

NVMCOM 

NVMPRT 

NVMXCOH 

DATBCOM 

PRTYCOM 

PRTBAUD 

PRTYPRT 

DATBPRT 


port control block for comm port 
port control block for axtandad comm 
port control block for printer port 

default comm control block for comm 

default comm control block for printer port 

default comm control block for optional comm 

NVM comm control block for comm 

NVM comm control block for printer port 

NVM comm control block for optional comm 

NVM -> CCB values for comm data bits 

NVM -> CCB values for comm PARITY bit 

NVM -> CCB values for printer baud 

NVM -> CCB values for printer parity 

NVM ’> CCB values for printer data bits 


translation table from Comm control block 

to value to be programmed to generator 

the hack vector table of 4 double word 
pointers that points to user service routines 


This file contains all the tables and control blocks for the 
Commun 1 cat i on part of the BIOS. 


PORT CONTROL BLOCKS 


These blocks contain all the Information kept on each port . 


OFFSET NVMCOM 


0 , 0 . 0 , 0,0 

40H 

42H 


port A on the mother board 
port B on the mother board 
port B on the optional comm board 
port A on the optional comm board 

PORT CONTROL BLOCK FOR COMM 
device name 
St at us 

address of default device settings 
port address for modem signals 
baud rate generator address 
9600 baud 

image of S control registers 
7201 data register address 
port address of st at us/ c ont r o 1 reg 
FLAGS 

mask for dat ab i t s/ par 1 1 y 

receive char Interrupt service flag 

address of receive character 

interrupt service routine 
transmit buffer empty service flag 
address of transmit buffer empty 
serv 1 ce rout i ne 
status change service flag 
address of status change 
serv Ice rout 1 ne 

count of # times harware failed 


CBLEN dup (O) 


length of comm control block 


004A R 
50 I 


S + 2 

RBLEN-i^2*RBDFLT DUP (0) 


; ( last part of PORT CONTROL BLOCK ) 
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COMTAB 












TABLES 8 CONTROL BLOCKS 

FOR COMM PORTION OF 

VERSION 2 BIOS 

107 








108 








109 








1 10 

009 A 



PCPRT LABEL 

BYTE 


PORT CONTROL BLOCK FOR PRINTER 

1 1 1 

009A 

4C S3 54 


DB 

' LST ' 


device name 

1 12 

009D 

00 


DB 

0 


status 

1 13 

009E 

01 P2 R 


DW 

OFFSET NVMPRT 


address of default device settings 

1 14 

OOAO 

FFPF 


DW 

OFFFFH 


port address for modem signals 

1 1 5 

00A2 

OOOE 


DW 

OEH 


baud rate generator address 

1 1 6 

OOA4 

OO 


DB 

OH 


9600 baud 

1 1 7 

OOA5 

OO 00 OO 

OO 00 

DB 

O 

O 

O 

O 

O 


image of 5 control registers 

1 18 

OOAA 

004 1 


DW 

41H 


7201 data register address 

1 1 9 

OOAC 

0043 


DW 

43H 


port address of status/control reg 

1 20 

OOAE 

OO 


DB 

O 


FLAGS 

121 

OOAF 

FFOO 


DW 

OPFOOH 


mask for databits/par ity 

1 22 

OOB 1 

OO 


DB 

0 


receive char interrupt service flag 

123 

OOB2 

oooo 


DW 

0 


address of receive character 

124 

OOB4 

oooo 


DW 

0 


interrupt service routine 

1 25 

OOB 6 

OO 


DB 

0 


transmit buffer empty service flag 

126 

OOB7 

oooo 


DW 

0 


address of transmit buffer empty 

1 27 

OOB9 

OOOO 


DW 

0 


serv i ce rout i ne 

1 28 

OOBB 

OO 


DB 

0 


status change service flag 

129 

OOBC 

oooo 


DW 

0 


address of status change 

1 30 

OOBE 

OOOO 


DW 

0 


service routine 

1 3 1 

OOCO 

OO 


DB 

0 


count of # times harware failed 

1 32 








133 

OOC 1 

11 t 


DB 

CBLEN DUP (0) 


length of comm control block 

1 34 



00 





1 35 



1 





136 








137 

0002 

OOD4 R 


DW 

$♦2 


(last part of PORT CONTROL BLOCK) 

1 38 

0004 

50 I 


DB 

RBLEN<*-2«RBDFLT OUP 

(0) 


1 39 



OO 





1 40 



1 





141 








1 42 








1 43 








144 








145 








146 

0124 



PCXCOM LABEL 

BYTE 


PORT CONTROL BLOCK POR EXTENOED COMM 

1 47 

0124 

55 43 31 


DB 

' UC 1 ' 


device name 

1 48 

0127 

00 


DB 

0 


status 

1 49 

0128 

0203 R 


DW 

OFFSET NVMXCOM 


address of default device settings 

1 50 

01 2A 

0020 


DW 

20H 


port address for modem signals 

151 

01 2C 

002 1 


DW 

2 1 H 


baud rate generator address 

152 

01 2E 

EE 


DB 

OEEH 


9600 baud 

1 S3 

01 2P 

05 [ 


DB 

5 DUP (0) 


image of 5 control registers 

1 54 



OO 




i 

155 



] 




1 

156 








157 

0134 

0029 


DW 

29H 


7201 data register address 

1 58 

0136 

002B 


DW 

2BH 


port address of status/control reg 

159 

0138 

OO 


DB 

0 


FLAGS 


02-20-84 
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1 60 

0139 

FFOO 

DW 

OFFOOH 

mask for dat ab i t s/par i t y 

161 

01 3B 

00 

DB 

0 

receive char interrupt service flag 

1 62 

013C 

OOOO 

DW 

0 

address of receive character 

1 63 

013E 

0000 

DW 

0 

interrupt service routine 

1 64 

0140 

00 

DB 

0 

transmit buffer empty service flag 

1 65 

0141 

OOOO 

DW 

0 

address of transmit buffer empty 

1 66 

0143 

OOOO 

DW 

0 

service routine 

1 67 

0145 

00 

DB 

0 

status change service flag 

1 68 

0146 

OOOO 

DW 

0 

address of status change 

1 69 

0148 

OOOO 

DW 

0 

ser V ice rout i ne 

170 

171 

172 

014A 

OO 

DB 

0 

count of # times harware failed 

014B 

1 1 I 

DB 

CBLEN DUF (0) 

length of comm control block 

173 


OO 




174 


1 




175 






176 

O 1 5C 

015E R 

DW 

$♦2 

; (last part of PDRT CONTRDL BLOCK) 

177 

O 1 SE 

60 ( 

DB 

RBLEN''-2»RBDFLT DUP (0) 



1 78 OO 

1 79 ] 

1 80 
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1 8 1 
182 

183 

184 

185 

186 

187 

188 

189 

190 
19 1 

192 

193 

194 

195 
198 

197 

198 

199 

200 
201 
202 

203 

204 

205 

206 

207 

208 

209 

210 
21 1 
212 

213 

214 

215 

216 

217 

218 

219 

220 


Default Coramun i cat i on Control Blocks (CCB) for each port. 


These CCB's define the default settings for each port. The reason 
that it is kept in this type of data structure is that the application 
porgram communicates with the BIOS to reprogram the devices in these 
CCB's. A seperate one is Kept for each port so that customising 
can be easily accomplished after the product is delivered. 

Note the following: 


1 - In order for the BIOS to function as defined, the state of 

the 7201 's must be known completely. The reason is that the 
application can ask for certain variables to be reprogrammed 
without reprogramming the whole 7201. This requires the valui 
that were programmed into the 7201 to be kept in memory. 
However, on power up. the firmware already programmed the 72< 
and has not kept a copy of the control registers. This leave 
only two alternat i ves, either guess what values were program) 
reading NVM, or reprogram the devices with a new set of va1u< 
which may be different from what is in NVM. 


The problem with reading the NVM are as follows: 

a) BIOS become hardware dependent. 

b) Code is generated is large and awkward because 

of the way NVM is set up (VT102 hsa some funny rules 
about implied NVM variables; eg there is no variable 
the number of data bits for the printer, it is implii 
from the baud rate specified'). 


The approach 
independent of the 
will be written to 
reading the NVM. 


taken here is to define a set of different defaults 
NVM. If this becomes undesirable, a utility program 
fill these data structures with values deduced from 


by 
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22 1 
222 
223 

01 AE 


TABLES 8 CONTROL BLOCKS 
OFLTCOM LABEL 

FOR COMM PORTION 
BYTE 

OF VERSION 2 BIOS 
default table for Comm 

224 

01 AE 

01 

OB 

1 

port number for coram 

225 

01 AF 

01 

OB 

1 

mode - data leads only 

226 

01 BO 

01 

OB 

1 

one stop bit 

227 

01 B1 

05 

OB 

5 

7 Space data bits 

228 

01B2 

01 

OB 

1 

no par i t y 

229 

0 IB 3 

10 

DB 

1 6 

9600 receive baud rate 

230 

01 B4 

10 

OB 

1 6 

9600 transmit baud rate 

231 

01 B5 

1 1 

DB 

DC 1 

xon character to be used 

232 

01 B6 

13 

DB 

DC3 

xoff charcter to be used 

233 

01 B7 

02 

DB 

2 

receive auto XON/XOFF enabled 

234 

01 B8 

02 

DB 

2 

transmit auto XON/XOFF enabled 

235 

01 B9 

OOOO 

DW 

O 

no newly defined receive buffer 

236 

01 BB 

OOOO 

DW 

0 

237 

01 BD 

OOOO 

DW 

0 


236 

239 

240 

01 BF 


DFLTPRT LABEL 

BYTE 

default table for printer 

24 1 

01 BF 

02 

DB 

2 

port number for printer 

242 

01 CO 

01 

DB 

1 

mode - data leads only 

243 

01 Cl 

01 

OB 

1 

one stop bit 

244 

01 C2 

04 

DB 

4 

8 data bits 

245 

01 C3 

03 

DB 

3 

No parity 

246 

01 C4 

OE 

DB 

1 4 

4800 receive baud rate 

247 

01 C5 

OE 

DB 

1 4 

4800 transmit baud rate 

248 

01 C6 

1 1 

DB 

DC 1 

xon character to be used 

249 

01 C7 

1 3 

DB 

DCS 

xoff charcter to be used 

250 

01 C8 

02 

DB 

2 

receive auto XON/XOFF enabled 

25 1 

01 C9 

02 

DB 

2 

transmit auto XON/XOFF enabled 

252 

01 CA 

OOOO 

DW 

O 

no newly defined receive buffer 

253 

01 CC 

OOOO 

DW 

O 

254 

01 CE 

OOOO 

DW 

O 


255 

256 

01 DO 


DFLTXCOM LABEL 

BYTE 

default table for extended Comm 

257 

0100 

03 

DB 

3 

port number for x comm 

258 

010 1 

01 

DB 

1 

mode - data leads only 

259 

0102 

01 

DB 

1 

one stop bit 

260 

0103 

05 

DB 

5 

7 space data bits 

26 1 

0104 

OO 

DB 

O 

no parity change 

262 

01 05 

1 O 

DB 

1 6 

9600 receive baud rate 

263 

0106 

1 O 

DB 

1 6 

9600 transmit baud rate 

264 

0107 

1 1 

DB 

DC 1 

xon character to be used 

265 

0108 

1 3 

OB 

DCS 

xoff charcter to be used 

266 

0109 

02 

DB 

2 

receive auto XON/XOFF enabled 

267 

01 OA 

02 

DB 

2 

transmit auto XON/XOFF enabled 

268 

01 OB 

OOOO 

DW 

0 

no newly defined receive buffer 

269 

0100 

OOOO 

DW 

O 

270 

01 OF 

OOOO 

DW 

o 
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27 1 

272 

273 

01 E 1 


TABLES 8 CONTROL BLOCKS 
NVMCOM LABEL 

FOR COMM PORTION 
BYTE 

OF VERSION 2 BIOS 
default table for Comm 

274 

01 El 

O 1 

DB 

1 

port number for comm 

275 

01 E2 

01 

DB 

1 

mode - data leads only 

276 

01 E3 

oi 

DB 

1 

one stop bit 

277 

01 E4 

05 

DB 

5 

7 Space data bits 

278 

01 E5 

01 

DB 

1 

no par i t y 

279 

01 E6 

10 

DB 

1 6 

9600 receive baud rate 

280 

01 E7 

10 

DB 

1 6 

9800 transmit baud rate 

28 1 

01 E8 

1 1 

DB 

DC 1 

xon character to be used 

282 

01 E9 

1 3 

DB 

DC3 

xoff charcter to be used 

283 

01 EA 

02 

DB 

2 

receive auto XON/XOFF enabled 

284 

01 EB 

02 

DB 

2 

transmit auto XON/XOFF enabled 

285 

01 EC 

OOOO 

DW 

O 

no newly defined receive buffer 

286 

01 EE 

OOOO 

DW 

O 

287 

01 FO 

OOOO 

DW 

o 


288 

289 

290 

01 F2 


NVMPRT LABEL 

BYTE 

default table for printer 

29 1 

01 F2 

02 

DB 

2 

port number for printer 

292 

01 F3 

01 

DB 

1 

mode - data leads only 

293 

01 F4 

01 

DB 

1 

one stop bit 

294 

01 F5 

04 

DB 

4 

8 data bits 

295 

01 F6 

0 1 

DB 

1 

No parity 

296 

01 F7 

OE 

DB 

1 4 

4800 receive baud rate 

297 

01 F8 

OE 

OB 

1 4 

4800 transmit baud rate 

298 

01 F9 

1 1 

DB 

DC 1 

xon character to be used 

299 

01 FA 

13 

OB 

0C3 

xoff charcter to be used 

300 

01 FB 

02 

DB 

2 

receive auto XON/XOFF enabled 

301 

01 FC 

02 

DB 

2 

transmit auto XON/XOFF enabled 

302 

01 FO 

OOOO 

DW 

0 

no newly defined receive buffer 

303 

01 FF 

OOOO 

DW 

O 

304 

0201 

OOOO 

DW 

0 


305 

306 

0203 


NVMXCOM LABEL 

BYTE 

default table for extended Comm 

307 

0203 

03 

DB 

3 

port number for x comm 

308 

0204 

01 

DB 

1 

mode - data leads only 

309 

0205 

01 

DB 

1 

one stop bit 

310 

0206 

05 

DB 

5 

7 space data bits 

31 1 

0207 

OO 

DB 

0 

no parity change 

312 

0208 

10 

DB 

1 6 

9600 receive baud rate 

313 

0209 

10 

DB 

1 6 

9600 transmit baud rate 

314 

020A 

1 1 

DB 

DC 1 

xon character to be used 

315 

020B 

13 

DB 

0C3 

xoff charcter to be used 

316 

020C 

02 

DB 

2 

receive auto XON/XOFF enabled 

3 1 7 

0200 

02 

OB 

2 

transmit auto XON/XOFF enabled 

318 

020E 

OOOO 

DW 

O 

no newly defined receive buffer 

319 

02 10 

OOOO 

OW 

0 

320 

0212 

OOOO 

DW 

o 


321 

322 

0214 


DATBCOM LABEL 

BYTE 

NVM -> CCB values for comm data bits 

323 

02 1 4 


DATBPRT LABEL 

BYTE 

NVM -> CCB values for printer data bits 
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TABLES 8 CONTROL 

BLOCKS 

FOR COMM PORTION 

OF VERS 

ION 

2 BIOS 

324 

0214 

03 

03 

03 

06 

05 

04 

OB 

3, 3, 3, 6. 5. 4, 4, 4 





325 


04 

04 











326 














327 

021C 






PRTYCOM 

LABEL 

BYTE 

; NVM 

- > 

CCB 

va 1 ues 

328 

02 1 C 






PRTYPRT 

LABEL 

BYTE 

; NVM 

- > 

CCB 

va 1 ues 

329 

02 1C 

02 

01 

03 

03 

03 

02 

OB 

2, 1.3, 3, 3, 2, 1,3 





330 


O 1 

03 











331 














332 

0224 






PRTBAUD 

LABEL 

BYTE 

; NVM 

- > 

CCB 

va 1 ues 

333 

0224 

02 

05 

07 

08 

09 

OC 

OB 

2,5,7,8.9,12,14, 

1 6 




334 


OE 

1 O 











335 
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VERSION 2 BIOS 


336 

337 

338 

339 

340 
34 1 

342 

343 022C 

344 022C 

345 

346 

347 

348 023D 

349 0230 

350 

351 

352 

353 


oo oi 

06 07 
OC 00 


FF OO 
02 03 
FF 06 


02 03 
08 09 
FF OE 


FF FF 
04 FF 
FF 07 


04 05 
OA OB 
OF 


0 1 FF 
FF 05 
FF 


BAUD RATE TRANSLATION TABLES. If the value 
baud rate not supported for that device. 


XBAUD1 LABEL 
OB 


BYTE ; table for 

0.1, 2, 3. 4, 5, 6. 7, 8 , 9. OAH , OBH . OCH . OOH 


XBAUD2 LABEL 
OB 


BYTE ; table for 

OFFH.O,OFFH,OFFH, 1 .0FFH,2,3.4.0FFH, 


for comm PARITY bit 
for printer parity 


for printer baud 


is FF, the particular 


COMM 8 XCOMM 
, OFFH . OEH , OFH 


pr i nt er 

iFFM,S,OFFH,6,OFFM,7,OFFH 


024E 


CODE 


ENDS 

END 
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Macros : 


Name Length 

CALRET O001 

SEO 0002 

TABLE 0002 


Segments and groups: 


CGROUP . 
CODE . 

Symbo 1 s : 


Size align combine class 

GROUP 

024E BYTE PUBLIC 'CODE' 


N 


m e 


Type Value Attr 


A7201. . 
ABAUD. . 
AMODEM . 
APPXOF . 
AS7201 . 
ASeSUB . 
B7201. . 
BAKGRNO . 
BAUDMAX . 
BBAUO. . 
BITO . . 
BIT1 . . 
BIT2 . . 
BIT3 . . 
BIT4 . . 
BITS . . 
BITS . . 
BIT7 . . 
BMODEM . 
BRKERR . 
BS7201 . 
CBDATB . 
CBLEN. . 
CBMODE . 
CBPORT . 
CBPRTY . 
CBRADR . 
CBRCVB . 
CBRXOF . 
CBSIZE . 
CBSTART . 
CBSTPB . 
CBTXB. . 
CBTXOF . 


Number 0040 
Number OOOE 
Number 0002 
Alias BIT7 
Number 0042 
Number 00 1 A 
Number 0041 
Number 24AF 
Number OO 1 1 
Number 0006 
Number 0OO1 
Number 0002 
Number 0004 
Number 0008 
Number 0O10 
Number 0020 
Number 0040 
Number 0080 
Number OOFF 
Alias BIT7 
Number 0043 
Number 0003 
Number oo 1 1 
Number 0001 
Number OOOO 
Number 0004 
Number OOOO 
Number OOOS 
Number 0009 
Number OOOB 
L BYTE OOOO 
Number 0002 
Number 0006 
Number OOOA 


CODE 
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CBXOFF Number 0008 

CBXON Number 0007 

CLK16X Number 0040 

CR1 Number oool 

CR17201 Number 0015 

CR1TXBE Number 0002 

CR2 Number 0002 

CR27201 Number 0010 

CR3 Number 0003 

CR4 Number 0004 

CR5 Number 0005 

CTS Alias BIT3 

DATBCOM L BYTE 02 14 CODE Global 

OATBPRT L BYTE 0214 CODE Global 

DATMAX Number 0006 

DC1 Number O0 1 1 

0C3 Number 0013 

DEVCOM Number 0O01 

OEVMAX Number 0003 

DEVPRT Number 0002 

DEVXCOM Number 0003 

DFLTCOM L BYTE 01AE CODE Global 

DFLTPRT L BYTE 01BF CODE Global 

DFLTXCOM L BYTE 01DO CODE Global 

OSR Alias BIT2 

DTR Alias BIT2 

ENDTXBE Number 0028 

E0I72O1 Number 0038 

ERR7201 Number 0030 

FRMERR Alias BITS 

HVECTOR L WORD OOOO CODE Global 

MOOEMAX Number 0002 

NVMCOM L BYTE 01E1 CODE Global 

NVMPRT L BYTE 01F2 CODE Global 

NVMXCOM L BYTE 0203 CODE Global 

OVRERR Alias BITS 

PARERR Alias BIT4 

PC7201 Number 0010 

PCBAUD Number 0008 

^CCOM L BYTE 0010 CODE Global 

^CCRI Number OOOB 

^CCR2 Number OOOC 

^CCR3 Number OOOO 

PCCR4 Number OOOE 

**CCR5 Number OOOF 

PCOATB Number 0029 

PCDFLT Number 0004 

PCFAIL Number 0026 

PCFLAG Number 0014 

^CID Number OOOO 

PCLEN Number 0037 

PCMASK Number 0015 

PCMODE Number 0027 
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PCMODM Number 0006 

PCPRT L BYTE 009A CODE Global 

PCPRTY Number 002A 

PCRADR Number 0033 

PCRATE Number OOOA 

PCRCVA Number 0016 

PCRCVB Number 002B 

PCRCVF Number 0017 

PCRXOF Number 002F 

PCS7201 Number 0012 

PCSIZE Number 0031 

PCSTART L BYTE OOOO CODE 

PCSTAT Number 0003 

PCSTCA Number 0022 

PCSTCF Number 0021 

PCSTPB Number 0026 

PCTXB Number 002C 

PCTXOF Number 0030 

PCXCOM L BYTE 0124 CODE Global 

PCXMTA Number 0010 

PCXMTF Number OO 1 C 

PCXOFF Number 002E 

PCXON Number 0020 

PRTBAUO L BYTE 0224 CODE Global 

PRTYCOM L BYTE 02 1 C CODE Global 

PRTYMAX Number 0003 

PRTYPRT L BYTE 02 1 C CODE Global 

RBCOUNT Number OOOO 

RBDFLT Number 0020 

RBHEAD Number OOOC 

RBIN Number 0004 

RBLEN Number 00 1 0 

RBMAX Number 0002 

RBOUT Number 0006 

RBSTART L BYTE OOOO CODE 

RETAIL Number OOOE 

RBXOFF Number 0006 

RBXON Number OOOA 

RCVBRK Alias BITO 

RCVOFF Alias BITS 

RCVXOF Alias BIT6 

RI Alias BITO 

RLSD Alias BIT4 

RST7201 Number 00 18 

RTS Alias BIT3 

SPD I Alias B I T 1 

SPSEL A1 ias BITO 

SRI Number OO0 1 

SR2 Number 0002 

SR3 Number 0003 

SRLSD Alias BIT1 

SRTS Alias BIT1 

STPBMAX Number 0003 
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SX7201 Number OOlO 

XA7201 Number 0028 

XABAUO Number 0021 

XAMODEM Number OOFF 

XAS7201 Number 002A 

XB7201 Number 0029 

XBAUD1 L BYTE 022C CODE Global 

XBAUD2 L BYTE 0230 CODE Global 

XBMODEM Number 0002 

XBS7201 Number 002B 

XHTBRK Alias BIT3 

XMTXOF Alias BIT2 

XMTXON Alias BIT1 

7N Number O0 1 0 


Warning Severe 
Errors Errors 
O O 



COMTAB 


Symbol Cross Roforence (# is definition) Cref*1 

^ 28^ 28 26# 26 26# 26 26# 26 26# 26 26# 26 26# 26 

26# 26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 26 

26# 26 26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 

26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 

26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 

26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 

26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 26 26# 

26 26# 26 26# 26# 26 26# 26 26# 26 26# 26 26# 26 

26# 26 26# 26 26# 26 26# 26 26# 26 


A7201 26# 

ABAUD 26# 

AMODEM 26# 

APPXOF 26# 

AS7201 26# 

ASCSUB 26# 

B7201 26# 

BAKGRND 26# 

BAUDMAX 26# 

BBAUD 26# 

BIT© 26# 26 26 26 

Bill 26# 26 26 26 26 

BIT2 26# 26 26 26 

BITS 26# 26 26 

B1T4 26# 26 26 

BITS 26# 26 26 

BITS 26# 26 26 

BIT7 26# 26 

BMODEM 26# 

BRKERR 26# 

BS7201 26# 

CBDATB 26# 

CBLEN 26# 98 133 172 

CBMODE 26# 

CBPORT 26# 

CBPRTY 26# 

CBRADR 26# 

CBRCVB 26# 

CBRXOF 26# 

CBSI2E 26# 

CBSTART 26# 

CBSTPB 26# 

CBTXB 26# 

CBTXOF 26# 

CBXOFF 26# 

CBXON 26# 

CGROUP 21 23 23 23 23 

CLK16X 26# 

CODE 21 22# 22 362 

CR1 26# 

CR1 7201 26# 

CR1TXBE 26# 

CR2 26# 


COMTAB 






Symbol Cross Reference 


(# is def 

i n i t ion) 

Cref -2 


CR27201 

26# 





CR3 

26# 





CR4 

26# 





CRB 

26# 





CTS 

26# 





OATBCOM 

4 1 

322# 




DATBPRT 

45 

323# 




DATMAX 

26# 





DC1 

26# 

23 1 

248 264 

281 298 

3 1 4 

DC3 

26# 

232 

249 265 

282 299 

3 1 5 

DEVCOM 

26# 





DEVMAX 

26# 





DEVPRT 

26# 





DEVXCOM 

26# 





DFLTCOM 

35 

223# 




DFLTPRT 

36 

240# 




DFLTXCOM 

37 

256# 




DSR 

26# 





DTR 

26# 





ENOTXBE 

26# 





E0I72O1 

26# 





ERR7201 

26# 





FRMERR 

26# 





HVECTOR 

5 1 

69# 




MOOEMAX 

26# 





NVMCOM 

36 

78 

273# 



NVMPRT 

39 

1 1 3 

290# 



NVMXCOM 

40 

149 

306# 



OVRERR 

26# 





PARERR 

26# 





PC7201 

26# 





PCBAUD 

26# 





PCCOM 

31 

75# 




PCCR1 

26# 





PCCR2 

26# 





PCCR3 

26# 





PCCR4 

26# 





PCCR5 

26# 





PCDATB 

28# 





PCDFLT 

26# 





PCFAIL 

26# 





PCFLAG 

26# 




1 

PCID 

26# 





PCLBN 

26# 





PCMASK 

26# 





PCMOOE 

26# 





PCMODM 

26# 







COHTAB 


Symbol Cross Rsfsrencs 


(# is definition) Cref*3 


PCPRT 33 110# 

PCPRTY 26# 

PCRADR 26# 

PCRATE 26# 

PCRCVA 26# 

PCRCVB 26# 

PCRCVF 26# 

PCRXOF 26# 

PCS720 1 26# 

PCSIZE 26# 

PCSTART 26# 

PCSTAT 26# 

PCSTCA 26# 

PCSTCF 26# 

PCSTPB 26# 

PCTXB 26# 

PCTXOF 26# 

PCXCOM 32 146# 

PCXMTA 26# 

PCXMTF 26# 

PCXOFF 26# 

PCXON 26# 

PRTBAUD 43 332# 

PRTYCOM 42 327# 

PRTYMAX 26# 

PRTYPRT 44 326# 

RBCOUNT 26# 

RBDFLT 26# 103 136 177 

RBHEAD 26# 

RBIN 26# 

RBLEN 26# 103 136 177 

RBMAX 26# 

RBOUT 26# 

RESTART 26# 

RETAIL 26# 

RBXOFF 26# 

RBXON 26# 

RCVBRK 26# 

RCVOFF 26# 

RCVXOF 26# 

RI 26# 

RLSD 26# 

RST7201 . . . . 26# 

RTS 26# 


SEO 


26 26 
26 26 
26 26 
26 26 
26 26 


26 26 
26 26 
26 26 
26 26 


26 26 
26 26 
26 26 
26 26 


26 26 
26 26 
26 26 
26 26 


26 26 
26 26 
26 26 
26 26 


26 26 
26 26 
26 26 
26 26 


26 26 
26 26 
26 26 
26 26 


SPDI 26# 

SPSEL 26# 

SRI 26# 
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Symbol Cross Reference 


(# is definition) Cref-4 


SR2 . . 

SR3 . . 

SRLSD . 
SRTS 
STPBMAX 
SX7201 


26# 

26# 

26# 

26# 

26# 

26# 


TABLE 


26 26 26 


XA7201 

XABAUO 

XAMODEM 

XAS7201 

XB7201 

XBAUD1 

XBAUD2 

XBMODEM 

XBS7201 

XMTBRK 

XMTXOF 

XMTXON 


26# 

26# 

26# 

26# 

26# 

48 343# 

49 348# 
26# 

26# 

26# 

26# 

26# 
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PACE .132 

TITLE COMNVM 

SUBTTL COLLECTION OF ROUTINE IN THE BIOS THAT READS NVM 


10 
1 1 
1 2 
13 
1 4 
1 5 
1 6 

17 OOOO 

1 8 

19 

20 


COMPANY CONFIDENTIAL 

Copyright (C) 1982. 1983 Digital Equipment Corporation 

All rights reserved. 


READNVM.A86 version /VOO-01/ JUN 07. 1983 DEVELOPMENT 

■ SECT CODE_SEC.REL 

CCROUP CROUP CODE 

CODE SEGMENT BYTE PUBLIC 'CODE' 

ASSUME CSiCGROUP. DS;CGROUP. ESiCGROUP. SS:CGROUP 
: NLIST 
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2 1 




.LIST 




22 




LIST 




23 

24 

25 




NML 1ST 


; do not list macro expansion 




PUBL I C 

RDNVMCOM 

Read 

NVM for comm, printer default 

26 

27 

28 






; opt i 

ona 1 comm, will take NVM COMM values 




EXTRN 

NVMCOM: BYTE 

; CCB 

for COMM 

29 




EXTRN 

NVMXCOM: BYTE 

; CCB 

for optional comm 

30 
3 1 
32 




EXTRN 

NVMPRT : BYTE 

; CCB 

for pr i nt er 




EXTRN 

DATBCOM: BYTE 

; NVM 

-> CCB values for comm data bits 

33 




EXTRN 

PRTYCOM: BYTE 

; NVM 

-> CCB values for comm parity 

34 




EXTRN 

PRTBAUD : BYTE 

; NVM 

-> CCB values for printer baud rates 

35 




EXTRN 

DATBPRT : BYTE 

; NVM 

-> CCB values for printer data bits 

36 

37 

38 

39 

40 




EXTRN 

PRTYPRT : BYTE 

; NVM 

-> CCB values for printer parity 

X 

EDOO 

NVMSEG 

EOU 

OEDOOH 

base 

address for NVM 

- 

0097 

SWSTOP 

EOU 

97H 

; NVM 

for # stop bits in COMM port 

4 1 

X 

0094 

SWXOFF 

EOU 

94H 

; NVM 

for auto enable xon/xoff for COMM 

42 

X 

OOAO 

CDTPTY 

EQU 

OAOH 

; NVM 

for # data and parity bits for COMM 

43 


OOA1 

XBCOMM 

EOU 

0A1 H 

; NVM 

transmit baud rate, for comm port 

44 

X 

OOA2 

RBCOMM 

EOU 

OA2H 

; NVM 

for receive baud rate for comm port 

45 

X 

00A5 

POTPTY 

EOU 

0A5H 

; NVM 

for # data and parity bit for printer 

46 

X 

OOA6 

PBCOMM 

EOU 

OA6H 

; NVM 

transmit and receive baud for printer 


47 
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4S 








49 








B1 








52 






RDNVMCOM 


53 








54 




Th i s 

routine Is called to read the NVM 

and translate the values In NVM 

55 




for 

the COMM, 

PRINTER and put them Into the BIOS comm control tables. 

56 




E«ch 

1 1 me t hat 

Its called, all 3 Comm 

control tables are updated, the 

57 




optional conm 

table will take the values from the comm. 

58 








59 




EXTRY CONDITIONS: OS 

points to BIOS data area 

60 








61 




EXIT 

CONDITIONS: OS:BX 

saved 

62 






CH 

saved 

63 
















65 








66 

oooo 



(DNVMCOH: 



67 

oooo 

53 



PUSH 

BX 


68 

000 1 

BE 

OOOO E 


MOV 

SI. OFFSET NVMCOM 

get address of Comm CCB to be built 

69 

0004 

BF 

OOOO E 


MOV 

DI , OFFSET NVMXCOM 

get address of optional comm CCB 

70 

0007 

B8 

EOOO 


MOV 

AX . NVMSEC 

; point ES to NVM 

7 1 

OOOA 

8E 

CO 


MOV 

ES . AX 


72 








73 

OOOC 

BO 

01 


MOV 

AL . 1 

assume one stop bit for comm port 

74 

OOOE 

26 

F6 06 0097 01 


TEST 

ES : BYTE PTR SWSTOP.BITO 

; check If Its one stop bit 

75 

0014 

74 

02 


JZ 

LI 1$ 

; If not. set It to 2 stop bits 

76 

0016 

BO 

03 


MOV 

AL , 3 


77 

0018 

88 

44 02 

LI 1$ : 

MOV 

CBSTPB [SI 1 . AL 

; save It In the comm CCB 

78 

0019 

88 

45 02 


MOV 

CBSTPB[D1 ] , AL 

save It In the optional comm port CCB 

79 








80 

001 E 

BO 

oi 


MOV 

AL , 1 

; assume auto xon/xoff enabled 

81 

0020 

26 : 

; F6 06 0094 OI 


TEST 

ES : BYTE PTR SWXOFF.BITO 

If NVM Indicates disabled then. 

82 

0026 

74 

02 


JZ 

LI 2$ 


83 

0028 

FE 

CO 


I NC 

AL 

set marker to disable It 

84 

002A 

88 

44 09 1 

LI 2$ ; 

MOV 

CBRXOF[SI 1 , AL 

mark comm port 

85 

002D 

88 

44 OA 


MOV 

CBTXOF[SI ] . AL 


86 

0030 

88 

45 09 


MOV 

CBRXOF[DI ] , AL 

mark optional comm port 

87 

0033 

88 

45 OA 


MOV 

CBTXOF [ DI 1 . AL 


88 








89 

0036 

26 : 

; AO OOA1 


MOV 

AL.ES: BYTE PTR XBCOMM 

get transmit baud rate 

90 

003A 

24 

OF 


AND 

AL . OFH 

mask out unwanted bits 

9 1 

003C 

FE 

CO 


I NC 

AL 

; If nvm value < E, add 1 

92 

003E 

3C 

OF 


CMP 

AL . OFH 


93 

0040 

72 

02 


JB 

L 1 3$ 


94 

0042 

FE 

CO 


INC 

AL 

; else add 2 

95 

0044 

88 

44 06 1 

LI 3$: 

MOV 

CBTXB[SI 1 , AL 

; put it into Comm CCB 

96 

0047 

88 

45 06 


MOV 

CBTXB [ DI ] , AL 

; put it into optional comm CCB 

97 

004A 

26 

: AO OOA2 


MOV 

AL.ES: BYTE PTR RBCOMH 

get receive baud rate 

98 

004E 

24 

OF 


AND 

AL . OFH 

mask out unwanted bits 

99 

0050 

FE 

CO 


INC 

AL 

if nvm value < E, add 1 

100 

0052 

3C 

OF 


CMP 

AL , OFH 
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101 


0054 

72 

02 


JB 

L 1_4$ 



102 


0056 

FE 

CO 


INC 

AL 

else add 2 


103 


0058 

88 

44 05 

L 1_4$ 

MOV 

CBRCVB[S1 ] , AL 

put it into Comm CCB 


1 04 


005B 

88 

45 05 


MOV 

CBRCVB [ D I ] , AL 

put it into optional comm CCB 


105 










106 


005E 

26 

AO OOAO 


MOV 

AL.ES: BYTE PTR CDTPTY 

get data and parity bits 


107 


0062 

24 

OF 


AND 

AL . OFH 

mask out unwanted bits 


108 


0064 

50 



PUSH 

AX 

save for later 


109 


0065 

BB 

OOOO E 


MOV 

BX. OFFSET DATBCOM 

translate to get # data bits 


1 10 


0068 

07 



XLAT 

BYTE PTR DATBCOM 



1 1 1 


0069 

88 

44 03 


MOV 

CBDATB [S I ] . AL 

put it In Comm CCB 


1 12 


006C 

88 

45 03 


MOV 

CBDATB [ D 1 ] . AL 

put it In optional comm CCB 


1 13 


006F 

58 



POP 

AX 

now get parity 


1 14 


0070 

BB 

OOOO E 


MOV 

BX. OFFSET PRTYCOM 



1 15 


0073 

07 



XLAT 

PRTYCOM 



1 1 6 


0074 

88 

44 04 


MOV 

CBPRTYISI ] . AL 

save it in comm CCB 


1 17 
1 18 
1 19 


0077 

88 

45 04 


MOV 

CBPRTYIDI 1 . AL 

save it in optional comm CCB 






; Now 

set up 

the printer CCB 



1 20 










121 


007A 

BE 

OOOO E 


MOV 

SI. OFFSET NVMPRT 

address of printer CCB default 

table 

1 22 


0070 

26 

AO OOAS 


MOV 

AL.ES: BYTE PTR PDTPTY 

get data bits and parity 


1 23 


008 1 

24 

OF 


AND 

AL , OFH 

take out unwanted bit 


1 24 


0083 

50 



PUSH 

AX 

save value for later 


125 


0084 

BB 

OOOO E 


MOV 

BX. OFFSET DATBPRT 

translate into CCB values 


126 


0087 

07 



XLAT 

BYTE PTR DATBPRT 



1 27 


0088 

88 

44 03 


MOV 

CBDATBISI 1 , AL 

put it Into printer CCB 


1 28 


008B 

58 



POP 

AX 

now translate the parity 


1 29 


008C 

BB 

OOOO E 


MOV 

BX, OFFSET PRTYPRT 



1 30 


008F 

D7 



XLAT 

BYTE PTR PRTYPRT 



131 


0090 

88 

44 04 


MOV 

CBPRTY [S I ] , AL 

save It Into printer CCB 


132 










133 


0093 

26 : 

: AO OOAS 


MOV 

AL.ES: BYTE PTR PBCOMH 

printer baud rate, and implied 

stop bits 

134 


0097 

24 

OF 


AND 

AL . OFH 

get rid of unwanted bits 


135 


0099 

B4 

OI 


MOV 

AH . 1 

assume 1 stop bit 


136 


009B 

75 

02 


JNZ 

L 1 9$ 

(if baud rate 75, ts 2 stop bits) 

1 37 


009D 

B4 

03 


MOV 

AH?3 



1 38 


009F 

88 

64 02 

L 1__9$ 

MOV 

CBSTPB[SI ] . AH 

save # stop bits into printer 

CCB 

139 


OOA2 

BB 

OOOO E 


MOV 

BX. OFFSET PRTBAUD 

translate printer baud rates 


140 


OOAS 

D7 



XLAT 

BYTE PTR PRTBAUD 



141 


OOA6 

88 

44 05 


MOV 

CBRCVB[SI ] , AL 

save it into printer CCB 


142 


OOA9 

88 

44 06 


MOV 

CBTXBtSIl.AL 



143 










144 


OOAC 

5B 



POP 

BX 

restore caller's register 


145 


OOAD 

C3 



RET 


return to caller 


146 










147 


OOAE 



CODE 

ENDS 




148 






END 
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Macros : 


Name Longth 

CALRET 
SE9. . 

TASLE . 

Sagmants and groups: 


Rama Siza align corabina 

CGROUR GROUP 

CODE OOAE BYTE PUBLIC 

Symbols : 

N a m a Typa Valua Attr 

A7201 Numbar 0040 

ABAUD Numbar OOOE 

AMOOEM Numbar 0002 

APPXOF Alias BIT7 

AS7201 Numbar 0042 

ASesUB Numbar OOIA 

S7201 Numbar 0041 

BAKGRNO Numbar 24AF 

BAUDMAX Numbar OOll 

BBAUD Numbar 0006 

BITO Numbar O001 

BIT1 Numbar 0002 

BIT2 Number 0004 

BITS Number 0008 

BIT4 Number O0 1 0 

BITS Numbar 0020 

BIT6 Number 0040 

BIT7 Number 0080 

BMODEM Numbar OOFF 

BRKERR Alias BIT7 

BS7201 Number 0043 

CBDATB Number 0003 

CBLEN Number OOll 

CBHODE Number OOO 1 

CBPORT Number OOOO 

CBPRTY Number 0004 

CBRADR Number OOOO 

CBRCVB Number 0005 

CBRXOF Number 0009 

CBSIZE Number OOOB 

CBSTART L BYTE OOOO CODE 

CBSTPB Number 0002 

CBTXB Number 0006 

CBTXOF Number OOOA 


0001 

0002 
0002 
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CBXOFF Number 0008 

CBXON Number 0007 

COTPTY Number OOAO 

CLK16X Number 0040 

CRl Number 0001 

CR17201 Number 00 15 

CR1TXBE Number 0002 

CR2 Number 0002 

CR27201 Number 0010 

CR3 Number 0003 

CR4 Number 0004 

CR5 Number 0005 

CTS Alias BIT3 

DATBCOM V BYTE OOOO CODE 

DATBPRT V BYTE OOOO CODE 

DATMAX Number 0006 

DC1 Number OOl 1 

0C3 Number 0013 

DEVCOM Number 0001 

DEVMAX Number 0003 

DEVPRT Number 0002 

DEYXCOM Number 0003 

OSR Alias BIT2 

OTR Alias B1T2 

ENDTXBE Number 0028 

E0I72O1 Number 0038 

ERR7201 Number 0030 

FRMERR Alias BIT6 

L NEAR 0018 CODE 

L 1^2$ L NEAR 002A CODE 

L NEAR 0044 CODE 

l-1_4$ L NEAR 0058 CODE 

L1_8S L NEAR 009F CODE 

MODEMAX Number 0002 

NVMCOM V BYTE OOOO CODE 

NYMPRT V BYTE OOOO CODE 

NYMSEG Number EDOO 

NVMXCOM V BYTE OOOO CODE 

OVRERR Alias BITS 

PARERR Alias BIT4 

PBCOMM Number OOA6 

PC7201 Number OOlO 

PCBAUD Number 0008 

PCCR1 Number OOOB 

PCCR2 Number OOOC 

PCCR3 Number OOOO 

PCCR4 Number OOOE 

PCCR5 Number OOOF 

PCDATB Number 0029 

PCDFLT Number 0004 

PCFAIL Number 0026 

PCFLAG Number 0014 

PC ID Number OOOO 


c lass 

'CODE' 


Symbo 1 s - 2 


Ext erna 1 
Ext erna 1 


Ext er na 1 
Ext erna 1 

Ext er na 1 
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PCLBR Numbor 0037 

PCMASK Numbor 0015 

PCMODE Numbor 0027 

PCMODM Numbor 0006 

PCPRTY Numbor 002A 

PCRAOR Numbor 0033 

PCRATE Numbor OOOA 

PCRCVA Numbor 0016 

PCRCVB Numbor 002B 

PCRCVF Numbor 0017 

PCRXOF Numbor 002F 

PCS7201 Numbor 0012 

PCSIZE Numbor 0031 

PCSTART L BYTE OOOO CODE 

PCSTAT Numbor 0003 

PCSTCA Numbor 0022 

PCSTCF Numbor 0021 

PCSTPB Numbor 0028 

PCTXB Numbor 002C 

PCTXOF Numbor 0030 

PCXMTA Numbor OO 1 D 

PCXMTF Numbor 001C 

PCXOFF Number OOZE 

PCXON Numbor 002D 

POTPTY Number OOA5 

PRTBAUD V BYTE OOOO CODE 

PRTYCOM V BYTE OOOO CODE 

PRTYMAX Number 0003 

PRTYPRT V BYTE OOOO CODE 

RBCOMM Number 00A2 

RBCOUNT Number OOOO 

RBDFLT Number 0020 

RBHEAD Number OOOC 

RBIN Number 0004 

RBLEN Number 0010 

RBMAX Number 0002 

RBOUT Number 0006 

RBSTART L BYTE OOOO CODE 

retail Number OOOE 

RBXOFF Number 0008 

RBXON Number OOOA 

RCVBRK Alios BITO 

RCVOFF Alias BITS 

RCVXOF Alias BITS 

RDNVMCOM L NEAR OOOO CODE 

R1 Alias BITO 

RLSD Alias BIT4 

RST7201 Number 0018 

RTS Alias B1T3 

SPO I Alias B I T 1 

SPSEL Alias BITO 

SRI Number OO0 1 

SR2 Number 0002 
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SR3 . . 

SRLSD . 

SRTS . 

STPBMAX 

SWSTOP 

SWXOFF 

SX7201 

XA7201 

XABAUD 

XAMOOEM 

XAS7201 

XB7201 

XBCOMM 

XBMOOEM 

XBS7201 

XMTBRK 

XMTXOF 

XMTXON 

?N . . 


Number 0003 
Alias B I T 1 
Alias B I T 1 
Number 0003 
Number 0097 
Number 0094 
Number 0010 
Number 0028 
Number 0021 
Number OOFF 
Number 002A 
Number 0029 
Number 00A1 
Number 0002 
Number 002B 
Alias BI T3 
Alias B I T2 
Alias BIT1 
Number 0010 


Warning Severe 
Errors Errors 
o o 


Ext er na 1 
Ext er na 1 

Ext er na 1 


G 1 oba 1 


Symbo 1 s * 4 
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Symbol Cress Reforsnco 

?H 21# 

21 # 

21 # 

21 

21 

21 

21 

21 

21 # 


A7201 21# 

ABAUD 21# 

AMODBH 2 1# 

APPXOF 21# 

AS7201 21# 

ASCSUB 21# 

B7201 2 1# 

BAKGRNO 21# 

BAUOMAX 21# 

BBAUO 21# 

BIT© 21# 

Bill 21# 

BIT2 21# 

BIT3 21# 

BIT4 21# 

BITS 21# 

BITS 21# 

BIT7 21# 

BMOOEM 21# 

BRKERR 21# 

BS7201 21# 

CBOATB 21# 

CBLEN 21# 

CBMODE 21# 

CBPORT 21# 

CBPRTY 21# 

CBRADR 2 1# 

CBRCVB 21# 

CBRXOF 21# 

CBSI2E 21# 

CBSTART 21# 

CBSTPB 21# 

CBTXB 21# 

CBTXOF 21# 

CBXOFF 21# 

CBXON 21# 

COTPTY 42# 

CGROUP 16 

CLK16X 21# 

CODE 16 

CR1 21# 

CR17201 21# 

CR1TXBE 21# 


is def init ion} 


Cref - 1 



21 

21# 

21 

21# 

21 

21# 

21 

21# 

2 1 

21# 

21 

21# 

21 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 

21# 

21 

21# 

21 

21# 

21 

21# 

21 

21# 


21 

2 1 

21 

74 

81 

21 

2 1 

2 1 

2 1 


21 

2 1 

21 



21 

2 1 




21 

2 1 




21 

2 1 




2 1 

2 1 




21 






1 1 1 

1 1 2 

1 27 


1 1 6 

1 1 7 

131 


103 

104 

14 1 


84 

86 



77 

78 

138 


95 

96 

142 


85 

87 



106 




1 8 

1 8 

1 8 

1 8 

1 7# 

1 7 

147 



21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

2 1 

21 # 

21 

21 # 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 

21 # 

21 

21 # 

21 

21 # 

21 

21 # 

21 
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Symbol Cross Reference (# is definition) Cref-2 


CR2 21# 

CR27201 21# 

CR3 21# 

CR4 21# 

CR5 2 1# 

CTS 21# 

OATBCOM 32# 109 110 

DATBPRT 35# 125 126 

DATMAX 21# 

0C1 21# 

0C3 21# 

DEVCOM 21# 

DEVMAX 21# 

DEVPRT 21# 

DEVXCOM 21# 

DSR 21# 

DTR 21# 

ENDTXBE 21# 

E0I72O1 21# 

ERR7201 21# 

FRMERR 21# 

LI 1$ 75 77# 

Ll“2$ 82 B4# 

Ll”3$ 93 95# 

Ll”4$ 101 103# 

Ll“s$ 136 138# 

MODEMAX 2 1# 

NVMCOM 28# 68 

NVMPRT 30# 121 

NVMSEC 38# 70 

NVMXCOM 29# 69 

OVRERR 21# 

PARERR 21# 

PBCOMM 46# 133 

PC7201 21# 

PCBAUO 21# 

PCCR1 21# 

PCCR2 21# 

PCCR3 21# 

PCCR4 21# 

PCCR5 21# 

PCDATB 21# 

PCDFLT 2 1# 

jPCFAIL 21# 

PCFLAG 21# 

IPCID 21# 

PCLEN 21# 


21 

21 

21 # 

21 # 

21 # 

21 # 

21 # 

21 



COMNVM 


Symbol Cress Roforonco 


(# is definition) 


Cref -3 


PCMASK 2 1# 

PCMODE 21# 

PCMODM 2 1# 

PCPRTY 21# 

PCRADR 21# 

PCRATE 21# 

PCRCVA 21# 

PCRCVB 21# 

PCRCVF 21# 

PCRXOF 21# 

PCS7201 21# 

PCSI2E 21# 

PCSTART 21# 

PCSTAT 21# 

PCSTCA 21# 

PCSTCF 21# 

PCSTPB 21# 

PCTXB 21# 

PCTXOF 21# 

PCXMTA 21# 

PCXMTF 21# 

PCXOFF 21# 

PCXON 21# 

PDTPTY 45# 122 

PRTBAUD 34# 139 140 

PRTYCOM 33# 114 IIS 

PRTYMAX 21# 

PRTYFRT 36# 129 130 

RBCOMM 44# 97 

RBCOUNT 21# 

RBDFLT 21# 

RBHEAD 21# 

RBIN 21# 

RBLEN 21# 

RBMAX 2 1# 

RBOUT 21# 

RESTART 21# 

RETAIL 21# 

RBXOFF 21# 

RBXOR 21# 

RCVBRK 21# 


21 21 21 
21 21 21 
21 21 21 
21 21 21 


RCVOFF ... 21# 

RCVXOF 21# 

RDNVMCOM 25 

RI 21# 

RLSD . 21# 

RST7201 2 1# 

RTS 21# 

SEO 21 


2 1 
2 1 
21 
2 1 


21 
2 1 
21 
21 


21 

21 

21 

21 


2 1 
2 1 


21 
2 1 
2 1 
2 1 


2 1 
2 1 


21 
2 1 
2 1 


COMNVM 

Symbol Cross Reference (# is definition) Cref-4 


SPDI 21# 

SPSEL 21# 

SRI 21# 

SR2 21# 

SR3 21# 

SRLSD 21# 

SRTS 21# 

STPBMAX 21# 

SWSTOP 40# 74 

SWXOFF 41# 81 

SX7201 21# 

table 21 21 21 

XA7201 21# 

XABAUD 21# 

XAMODEM 21# 

XAS7201 21# 

XB7201 21# 

XBCOMM 43# 89 

XBMODEM 21# 

XBS7201 2 1# 

XMTBRK 21# 

XMTXOF 21# 

XMTXON 21# 
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2 

3 

A 

8 

S 

7 

8 
t 

10 
1 1 
12 

13 

14 

15 
1 6 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 
5 1 

52 

53 


PAGE ,132 

TITLE COMBIOS 

SUBTTL COMMUNICATION PORTION OF VERSION 2 BIOS 
NAME COMBIOS 


COMPANY CONFIDENTIAL 

Copyright (C) 1982, 1983 Digital Equipmant Corporation 

All rights reservad. 


COMBIOS .A86 


varslon /V00-01/ 
varslon /V00-02/ 


APRIL 11, 1983 DEVELOPMENT 

May 25, 1983 


1 

2 


3 


altarad tha Intarfacas so t 
control block doas not hava 
Taka out the sotting of tha 
INITCOM. 

Changa GETPCB so that thara 
application trios to accass 
conin board. 


hat tha comin 
to ba In usar OS . 
vactors in 

is an arror if 

non axistng optional 


varslon /VOO-03/ Jun 01, 1983 


NOTE 


1 - Compensate for the difference In hardware for 

ports on the mother board and tha optional comm 
board. The 1 nt or na 1 /ext or na 1 clock Is differently 
for both 7201. This Is compensated by always 
setting the modem signals to deasserted state 
on cold boot . 


2 


Fix the special receive condition for PORT 8 
of both 7201 . 


vers 1 on 

1 - Fix 

2 - Fix 

version 


/V00-04/ Jun 1 3 . 1983 

printer baud rate problem 
programming of 7M and 7S for a11 ports 

/V00-05/ Jun 20, 1983 


1 - Add error handling to programming of devices 

2 - Do not enable Interrupts In the driver 

3 - Mask out hi order bit before checking for 

xon/xoff type control characters. 


this module was to begin with. Inter 
may be desirable in the future, so t 
interrupts are enabled and disabled 
are just commented out with the foil 
that it can be easily changed 


ruptable, this 
he places where 
in the driver 
owing mark so 
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54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 
85 
66 
87 
68 


%1*>C 

6-23-83 Fix the interfaces to read and set modem 
s i gna 1 s . 


6- 27-83 

Add the hack as requested. 

That is add BIOS call to take over 1/2 7201 !! 

7- 01-83 

Add status change interrupt service calls 
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89 

70 

71 SECT CODE_SEC,REL 

72 

73 CGROUP GROUP CODE 

74 OOOO CODE SEGMENT BYTE PUBLIC 'CODE' 

75 ASSUME CS:CGROUP, OS:CGROUP. ES:CGROUP, SS:CGROUP 

76 

77 ; NLIST 
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COMMUNICATION PORTION OF 

VERSION 2 BIOS 


78 

.LIST 



79 




80 

EXTRN 

PCCOM: BYTE 

port control block for comm port 

8 1 

EXTRN 

PCXCOM; BYTE 

port control block for extended comm port 

82 

EXTRN 

PCPRT : BYTE 

port control block for printer port 

83 




84 

EXTRN 

DFLTCOM; BYTE 

default comm control block for comm 

85 

EXTRN 

DFLTXCOM : BYTE 

default comm control block for Xcomm 

86 

EXTRN 

DFLTPRT : BYTE 

default comm control block for printer port 

87 




88 

EXTRN 

XBAUD 1 : BYTE 

baud rate translation table for Comm 8 Xcomm 

89 

EXTRN 

XBAUD2 : BYTE 

baud rate translation table for printer 

90 




9 1 

EXTRN 

XOPTION : BYTE 

this is 2 ero, when optional comm port present 

92 

EXTRN 

RDNVMCOM: NEAR 

read NVM and set defaults 

93 




94 

EXTRN 

HVECTOR :WORD 

addresses of the user defined service routines 

95 




96 

PUBL I C 

RUPT7201 

address of mother board 7201 interrupt 

97 

PUBL I C 

XRUPT7201 

address of optional board 7201 interrupt 

98 

PUBL I C 

INITCOM 

cold start initialize of all 7201 

99 

PUBL I C 

WINITCOM 

warm start initialize of all 7201 

100 




101 

PUBLIC 

PRC7201 

reprogram 7201 

102 

PUBL I C 

DFLT7201 

reprogram 7201 to default values 

103 

PUBLIC 

DFLTBUF 

reset receive char buffer to default area 

104 

PUBL I C 

RDSETUP 

read device setup information 

1 05 

PUBL I C 

RCVENA 

receiver enable 

106 

PUBL I C 

RCVDIS 

receiver disable 

107 

PUBL I C 

INSTAT 

get input status 

1 08 

PUBLIC 

INCHAR 

get input character 

1 09 

PUBLIC 

GETCHAR 

get input char return when available 

1 10 

PUBL I C 

OUTSTAT 

get output status 

1 1 1 

PUBL I C 

OUTCHAR 

write character 

1 12 

PUBL I C 

PUTCHAR 

: write charcter, return when sucessful 

1 1 3 

PUBL I C 

OUTNOW 

write character immediately 

1 1 4 

PUBLIC 

RDMODEM 

read modem signals 

1 1 5 

PUBL I C 

SETMODEM 

set modem signals 

1 1 6 

PUBL 1 C 

BRKON 

transmit break 

1 1 7 

PUBL I C 

BRKOFF 

; cease transmission of break 

1 18 

PUBL I C 

RCVINT 

set receive character interrupt service 

1 1 9 

PUBLIC 

RCVCANCEL 

cancel receive char interrupt service 

1 20 

PUBL I C 

XMTMTY 

set transmit buffer empty service 

121 

PUBL I C 

XMTCANCEL 

cancel transmit buffer empty service 

122 




1 23 

PUBLIC 

HACK7201 

; setup 1/2 vector 

1 24 

PUBLIC 

VECT7201 

clean up redirection vector 

125 




126 

PUBL I C 

STATCHG 

status change service call 

1 27 

PUBLIC 

STCANCEL 

; cancel status change service calls 
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128 

128 

130 

131 

132 

133 

134 

135 

136 

137 
136 

138 

140 

141 

142 

143 

144 

145 

146 

147 

148 
148 

150 

151 
1 S2 
1S3 
1 54 

155 

156 

157 
1 58 
1 58 
1 60 
1 6 1 
1 62 

53 
52 

BB OOEA R 
BA 0043 
EB 08 


S3 

52 

BB OOFA R 
BA 002B 


163 OOOO 

164 OOOO 

165 O0O1 

166 0002 

167 0005 

188 0008 

1 69 

170 OOOA 

171 OOOA 

172 OOOB 

173 OOOC 

174 OOOF 


SUBTTL INTERRUPT SERVICE ROUTINES 


R U P T 7 2 O 


XRUPT7201 


This Is th« Intorrupt handler routine for the 7201. on the mother 
board, and the equivalent for the extended comm. 

These 2 routines are setup to share some common code. 

Status register 2 of the 7201 will indicate the reason for the 
interrupt. This will be used as a table lookup to call the appropriate 
serv ice rout ine . 

Since the only difference between the 2 interrupt handlers are the 
service routine table and the 7201 data port address, the two routines 
can be setup to use some common code. 

All the service routines Itables INT7201 . and XINT7201) must follow the 
the following interfaces: 

ON ENTRY TO THE SERVICE ROUTINES: 

AX. BX. CX. OX. OS. ES, BP are saved and can be used in 

in any way. 

OX contains the address of port A of the corresponding 
7201 . 

OS will point to the BIOS data area (ie same as CS ) 


RUPT7201 : 

PUSH 

PUSH 

MOV 

MOV 

JMP 

XRUPT7201 ; 

PUSH 

PUSH 

MOV 

MOV 


BX 

OX 

BX. OFFSET INT7201 

OX . BS7201 

SHORT RUPTCOMMON 


BX 

OX 

BX. OFFSET XINT7201 
DX . XBS7201 


comm service routine 
save registers 

get the service routine table 

get 7201 port B, status/control reg 

> go to common table lookup portion 

(Xtended comm service routine) 
save registers 

get service routine table 

get 7201 port B, status/control reg 
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1 75 
176 
1 77 


1 78 

0012 



RUPTCOMMON : 


179 

O01 2 

50 


PUSH 

AX 

1 80 

0013 

1 E 


PUSH 

DS 

1 8 1 

0014 

8C 

C8 

MOV 

AX . CS 

182 

001 6 

BE 

D8 

MOV 

DS . AX 

1 83 

0018 

89 

26 OOA6 R 

MOV 

SAVE SP.SP 

1 84 

001 C 

8C 

16 OOA8 R 

MOV 

SAVE”sS . SS 

1 85 

0020 

8E 

DO 

MOV 

SS . a7 

186 

0022 

BC 

OOEA R 

MOV 

SP, OFFSET COMM STAO 

187 

0025 

5 1 


PUSH 

CX 

188 

0026 

56 


PUSH 

SI 

1 89 

0027 

57 


PUSH 

DI 

190 

0028 

06 


PUSH 

ES 

1 9 1 

0029 

55 


PUSH 

BP 

192 






193 

002A 



NXTINT : 


194 

002A 

33 

CO 

XOR 

AX . AX 

195 

002C 

EE 


OUT 

DX . AL 

196 

002D 

BO 

02 

MOV 

AL , 2 

197 

002F 

EE 


OUT 

DX , AL 

196 

0030 

EC 


IN 

AL . DX 

199 






200 

003 1 

3C 

07 

CMP 

AL . 7 

201 

0033 

76 

30 

JBE 

NXTINT 1 

202 






203 

0035 

83 

FA 43 

CMP 

DX . BS7201 

204 

0038 

75 

1 A 

JNZ 

L 1 1$ 

205 

003A 

BA 

0042 

MOV 

DX, OFFSET AS7201 

206 

O03D 

E8 

0904 R 

CALL 

RESET7201 

207 

0040 

BB 

OOOO E 

MOV 

BX. OFFSET PCCOM 

208 

0043 

FE 

47 26 

INC 

BYTE PTR PCFAILIBX] 

209 

004 6 

E8 

0083 R 

CALL 

CR7201 

2 10 

0049 

BB 

OOOO E 

MOV 

BX, OFFSET PCPRT 

2 1 1 

004C 

FE 

47 26 

INC 

BYTE PTR PCFAILIBX] 

2 1 2 

004F 

E8 

0083 R 

CALL 

CR7201 

2 1 3 

0052 

EB 

1 D 

JMP 

SHORT INTEXIT 

214 






215 

0054 



LI 1$: 


216 

0054 

BA 

002A 

MOV 

DX, OFFSET XAS7201 

217 

0057 

E8 

0904 R 

CALL 

RESET7201 

2 1 8 

OOSA 

BB 

OOOO E 

MOV 

BX, OFFSET PCXCOM 

219 

0050 

FE 

47 26 

INC 

BYTE PTR PCFAIL(BX) 

220 

0060 

E8 

0083 R 

CALL 

CR7201 

221 

0063 

EB 

OC 

JMP 

SHORT INTEXIT 

222 






223 

0065 



NXTINT1 ; 



224 

225 

226 
227 


STI 

SHL 

ADD 

PUSH 


common code for both service routines 
save rest of registers needed 

set up DS to point to BIOS data area 

Save stack pointers 

Copy CS : :> SS: 

Setup local stack 


make sure certain idiot programs 
don't mess reg pointer 
set up to read status register 2 B 
. ( not e AH still O ) 


Range check the value to make sure 
; (should be O to 7) 

; check if its comm 8 printer 7201 
; If so then 

reset whole 7201 

reprogram port A of 
count up # hardware 
(put back images of 
reprogram port B of 
count up 0 hardware 
; (put back images of 

; exit from interrupt 

: (problem in optional comm 

; reset whole 7201 

; reprogram port A of 7201 
; count up # hardware failures 
(put back images of 7201 reg) 

; exit from interrupt 


; enable interrupts 

; multiply to use it as table offsets 
; find address of service routine 
; save port B address 


7201 

f a i lures 
7201 reg) 
7201 

fa i lures 
7201 reg) 


port ) 


0065 D1 EO 
0067 03 D8 

0069 52 


AX . 1 
BX . AX 
DX 
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228 

006A 

PF 

1 7 

CALL 

WORD PTR IBX 

229 

006C 

5A 


POP 

OX 

230 

0060 

4A 


DEC 

OX 

23 1 

006E 

BO 

38 

MOV 

AL , E0I72O1 

232 

0070 

EE 


OUT 

OX . AL 

233 






234 

007 1 



INTEXIT : 


235 

0071 

5D 


POP 

BP 

236 

0072 

07 


POP 

ES 

237 

0073 

5F 


POP 

01 

238 

0074 

5E 


POP 

S I 

239 

0075 

59 


POP 

cx 

240 

0076 

8E 

1 6 00A8 R 

MOV 

SS.SAVE SS 

24 1 

007A 

8B 

26 OOA6 R 

MOV 

SP.SAVE SP 

242 

007E 

IF 


POP 

DS 

243 

007F 

58 


POP 

AX 

244 

0080 

5A 


POP 

OX 

245 

008 1 

5B 


POP 

BX 

246 

0082 

CF 


IRET 


247 






248 

0083 



CR7201 : 


249 

0083 

8B 

67 1 2 

MOV 

OX , PCS7201 ( B 

250 

0086 

8A 

47 OE 

MOV 

AL , PCCR4 [ BX ] 

25 1 

0089 

B4 

04 

MOV 

AH . 4 

252 

008B 

E8 

0269 R 

CALL 

WRITE7201 

253 

008E 

8A 

47 OB 

MOV 

AL . PCCR1 tBX ] 

254 

009 1 

B4 

O 1 

MOV 

AH , 1 

255 

0093 

E8 

0269 R 

CALL 

WRITE7201 

256 

0096 

8A 

47 OF 

MOV 

AL . PCCR5 I BX 1 

257 

0099 

B4 

05 

MOV 

AH , 5 

258 

0098 

E8 

0269 R 

CAL L 

WRI TE7201 

259 

009E 

8A 

47 OD 

MOV 

AL . PCCR3 [ BX ] 

280 

OOA1 

B4 

03 

MOV 

AH . 3 

26 1 




CALRET 

WRI TE7201 

262 

OOA3 

E9 

0269 R 

+ JMP 

WRI TE7201 

263 






264 




; I nt er na 1 st ack 

and saved po 

265 






266 

OOA6 

oooo 

SAVE SP DW 

0 

267 

OOA8 

oooo 

SAVE_SS DW 

o 

268 






269 

OOAA 


40 I 

OB 64 DUP (7) 

270 



*>•> 



27 1 



1 



272 






273 

s OOEA 


COMM_STACK 

EOU $ 

274 







; call sorvice routine 
restore port B address 
; get address of status/control 
; issue "end of interrupt" to 7 
; write it to control reg O ( po 


restore registers 


Restore entry stack 


a 1 1 done . ad i os ! 


get control register of 7201 
do CR4 first 


The Microsoft MACRO Assembler 
COMBIOS 


02-20-84 PAGE 

INTERRUPT SERVICE ROUTINES 


276 










278 










279 





I N T 7 2 0 

1 

8 


X I N T 7 2 0 1 

280 










28 1 




This is a table of offsets 

f OP 

the interrupt service routines for 

282 




the NEC 7201 

on the mother 

board, and the optional comm board. 

283 










284 




The offsets 

are set up to 

use the 7201 

status register 2 (status 

285 




affect vector) so that service 

routines can be fastest reached with 

286 




the 1 east code . 





287 










2ae 




NOTE ; these 

2 tables have 

to be cont 

i guous 











29 1 










292 

OOEA 


INT7201 LABEL 

WORD 





293 

OOEA 

021F 

R 

DW 

BTXEMT 


Port 

B 

transmit buffer empty 

294 

OOEC 

028B 

R 

DW 

BSTAT 


Port 

B 

external status change 

295 

OOEE 

0143 

R 

DW 

BRXDAT 


Port 

B 

receive character available 

296 

OOFO 

023E 

R 

DW 

BRXSPC 


Port 

B 

special receive condition 

297 

OOF2 

0215 

R 

DW 

ATXEMT 


Port 

A 

transmit buffer empty 

298 

OOF4 

0295 

R 

DW 

ASTAT 


Port 

A 

external status change 

299 

OOFS 

013E 

R 

DW 

ARXOAT 


Port 

A 

receive character available 

300 

OOF8 

0248 

R 

DW 

ARXSPC 


Port 

A 

special receive condition 

301 










302 

OOFA 


XINT7201 LABEL 

WORD 





303 

OOFA 

021 A 

R 

DW 

XBTXEMT 


Port 

B 

transmit buffer empty 

304 

OOFC 

0290 

R 

DW 

XBSTAT 


Porx 

B 

external status change 

305 

OOFE 

0148 

R 

OW 

XBRXDAT 


Port 

B 

receive character available 

306 

0100 

0243 

R 

DW 

XBRXSPC 


Port 

B 

special receive condition 

307 

0102 

0276 

R 

OW 

XATXEMT 


Port 

A 

transmit buffer empty 

308 

0104 

027A 

R 

OW 

XASTAT 


Port 

A 

external status change 

309 

0106 

0286 

R 

DW 

XARXDAT 


Port 

A 

receive character available 

310 

0108 

028 1 

R 

DW 

XARXSPC 


Port 

A 

special receive condition 


reg 2A 
201 
r t A ) 
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313 
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315 



3 1 6 
317 
3 18 
3 1 9 
320 
32 1 

010A 


322 

010A 

021F 

323 

010C 

028B 

324 

010E 

0143 

325 

0110 

023E 

326 



327 

0112 


328 

0112 

02 1 5 

329 

0114 

0295 

330 

0116 

013E 

33 1 
332 

0118 

0248 

333 

01 1 A 


334 

01 1 A 

021 A 

335 

01 1 C 

0290 

336 

01 1 E 

0148 

337 

0120 

0243 

338 



339 

0122 


340 

0122 

0276 

34 1 

01 24 

027A 

342 

0126 

0286 

343 

0128 

028 1 


DEFAULT TABLES OF SERVICE ROUTINES FOR THE 4 DEVICES 

PORTA. PORTB are for the 7201 on the mother board 
PORTXA. PORTXB, are for the 7201 on the optional comm port 


LABEL 

DW 

DW 

DW 

OW 

LABEL 

DW 

DW 

OW 

DW 

LABEL 

DW 

DW 

DW 

DW 

LABEL 

DW 

DW 

DW 

DW 


WORD 

BTXEMT 

BSTAT 

BRXOAT 

BRXSPC 

WORD 

ATXEMT 

ASTAT 

ARXDAT 

ARXSPC 

WORD 

XBTXEMT 

XBSTAT 

XBRXOAT 

XBRXSPC 

WORD 

XATXEMT 

XASTAT 

XARXDAT 

XARXSPC 


Port B transmit buffer empty 
Port B external status change 
Port B receive character available 
Port B special receive condition 


Port A transmit buffer empty 
Port A external status change 
Port A receive character available 
Port A special receive condition 


Port B transmit buffer empty 
Port B external status change 
Port B receive character available 
Port B special receive condition 


Port A transmit buffer empty 
Port A external status change 
Port A receive character available 
Port A special receive condition 
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344 

345 

346 012A 

347 012A 

348 012E 

349 

350 012F 

351 012F 

352 0133 

353 

354 0134 

355 0134 

356 0138 

357 

358 0139 

359 0139 

360 013D 

361 


FF IE OOOO E 
C3 


FF IE 0004 E 
C3 


FF IE 0008 E 
C3 


FF IE OOOC E 
C3 


HACKA : 

CALL 

RET 

HACKB : 

CALL 

RET 

HACKXB : 

CALL 

RET 

HACKXA : 

CALL 

RET 


DWORD PTR 
DWORD PTR 
DWORD PTR 
DWORD PTR 


H VECTOR 
HVECTOR+4 
HVECT0R4-8 
HVECT0R4- 1 2 



02-20>84 


PAGE 


15-1 


The Microsoft MACRO Assembler 
COHBIOS 

INTERRUPT SERVICE ROUTINES 


382 

363 

364 

365 

366 

367 
366 

369 

370 

37 1 

372 

373 

374 

375 

376 

377 
376 

379 

380 

38 1 

382 

383 

384 

385 

386 

387 

388 

389 

390 

39 1 

392 

393 

394 


01 3E 

013E BB OOOO E 
0141 EB 08 


O 1 43 

0143 BB OOOO E 

0146 EB 03 


01 48 

0148 BB OOOO E 


A R X D A T 

Receive character interrupt service routines. 

A11 three ports uses the same service routine, RECEIVER. 

On entry to RECEIVER. DS.BX must point to the appropriate Port Control Block. 


MOV 

JMP 


BX. OFFSET PCCOM 
SHORT RECEIVER 


Port A receive character available 

get offset of the COMM port control block 

go to common service routine. 


BRXDAT : 


MOV 

JMP 


BX, OFFSET PCPRT 
SHORT RECEIVER 


Port B receive character available 

get offset of the printer port control’ block 

go to common service routine 


XBRXDAT 


MOV 

JMP 


Port A receive character available 
BX. OFFSET PCXCOM ; get the extended COMM port control block 
SHORT RECEIVER ; go to common service routine 


note this code falls thru + + + + + + + 


! ! 


#### 
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395 

396 

397 

398 

399 

400 

401 

402 

403 

404 

405 

406 

407 

408 

409 


4 10 


4 1 1 


4 1 2 


4 1 3 

01 4B 

4 1 4 

01 4B 

415 

01 4E 

4 1 6 

0150 

417 

0 15 1 

4 1 8 

0155 

4 1 9 

0157 

420 

0159 

421 

01 5C 

422 

01 5F 

423 

016 1 

424 

01 65 

425 

01 67 

426 

01 6A 

427 

01 6C 

428 

01 70 

429 


430 


431 


432 


433 

0172 

434 

0172 

435 

0175 

436 

0177 

437 

0179 

438 

01 7C 

439 


440 

01 7D 

44 1 

018 1 

442 

0185 

443 

0189 

444 


445 


446 



447 


8B 

57 

10 


32 

E4 



EC 




80 

7F 

2F 

02 

75 

1 B 



8A 

DO 



80 

E2 

7F 


3A 

57 

2D 


75 

06 



80 

67 

1 4 

BF 

EB 

7C 



3A 

57 

2E 


75 

06 



80 

4F 

1 4 

40 

EB 

7 1 




8B 

57 

15 


22 

C6 



OA 

C2 



C4 

6F 

33 


50 




26 

8B 

46 

00 

26 

3B 

46 

02 

26 

8B 

7E 

04 

75 

1 5 




RECEIVER 

This is the common receive character routine 
character interrupt; for all 3 ports (port A 
board, and port B on the extended comm port). 


used to process the receive 
. B on the 7201 on the mother 


ENTRY CONDITIONS: DS:BX points to the port control block 

EXIT CONDITIONS: 

!> NOTE M REC3 is an embedded entry point from special receive characters 


RECE I VER : 

MOV 

XOR 

IN 

CMP 

JNE 

MOV 

AND 

CMP 

JNZ 

AND 

JMP 

REC 1 : CMP 

JNZ 
OR 
JMP 


DX , PC7201 ( BX ] 

AH , AH 
AL . OX 

BYTE PTR PCRXOF[BXl 

REC3 

DL , AL 

DL , 07FH 

DL . PCXON [ BX ] 

REC 1 

BYTE PTR PCFLAGIBX] 
SHORT RECX 
DL . PCXOFF I BX ] 

REC3 

BYTE PTR PCFLAGIBX] 
SHORT RECX 


; get data register of the 7201 PORT 
; Assume no error in character 
; read the character 

2 ; check if receiv auto XON/XOFF enabled 

; > if not, do not filter these chars 

; mask out hi order bit for xon/xoff 
; protocol charaacter ! • > 

check if we have XON character 
; If so clear flag for xoff received 
NOT RCVXOF 

; > exit 

check if we have XOFF 
; If not treat it like other characters 
RCVXOF else set flag, xoff received 


This is an embedded entry point for special 
AX has character from the 7201 (not yet mod 


receive characters M 
f i ed according to the mask) 


REC3 : 

MOV OX. PCMASK[BX] 

AND AL.DH 

OR AL.OL 

LES BP, DWORD PTR PCRADR[BX] 

PUSH AX 

; CLI 

MOV AX, ES ; RBCOUNT [ BP ] 

CMP AX.ES :RBMAX{BP] 

MOV 01 , ES : RBIN { BP ] 

JNZ REC6 

; buffer full, replace last character wi 


get the mask 

; alter the incoming character 

: get address of the receive buffer 
; save character to be written 
; make sure interrupts are disabled here 
; get # characters in the buffer 
; check to see if we are full 
; ( first get address for next char in) 

; If not go store character in buffer 

t h asc i i sub 


018B 58 


POP 


AX 


clean up stack 
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448 

018C 

26 

3B 

7E 

OC 


CMP 

01 ,ES:RBHEAD[BP] 

If next char in points to top of buffer 

449 

0190 

76 

06 




JNZ 

REC4 


450 

0192 

26 

SB 

7E 

OE 


MOV 

01 ,ES:RBTAILIBP] 

set pointer to tail of buffer 

451 

0196 

EB 

02 




JMP 

SHORT REC5 

go put ascii sub there 

452 

0198 





REC4 : 



Else, 

453 

0198 

4F 





DEC 

01 

get address of last input character 

454 

0199 

4F 





DEC 

01 


455 

01 9A 





REC5 : 



(now place ascii sub into buffer) 

456 

01 9A 

26 

C6 

05 

1 A 


MOV 

BYTE PTR ES : { 01 ] , ASCSUB 

put sub character there 

457 

01 9E 

EB 

43 




JMP 

SHORT RECX 

return to cal ler 

458 

01 AO 





REC6 : 




459 

01 AO 

40 





INC 

AX 

count up # characters in the buffer 

460 

01 A1 

26 

69 

46 

OO 


MOV 

ES :RBCOUNT(BP] , AX 

save new value for count 

461 

01 A5 

58 





POP 

AX 

restore character 

462 

01 A6 

26 

69 

05 



MOV 

ES : [01 ] . AX 

save new character 

463 

01 A9 

26 

3B 

7E 

OE 


CMP 

01 , ES : RBTAIL [ BP ] 

check if at end of buffer space 

464 

01 AD 

75 

06 




JNZ 

REC7 

If so update pointer to the beginning 

465 

01 AF 

26 

6B 

7E 

OC 


MOV 

01 ,ES :RBHEAD[BP] 


486 

0193 

EB 

02 




JMP 

SHORT REC8 


467 

0195 





REC7 : 



Else, increment input pointer 

468 

0195 

47 





INC 

01 

to next available buffer space 

469 

0186 

47 





INC 

01 


470 

0197 





REC8 : 



(now 01 points to next avail space) 

471 

0197 

26 

69 

7E 

04 


MOV 

ES : RBIN [ BP 1 , 01 

update new address 

472 

0169 

80 

7F 

30 

02 


CMP 

BYTE PTR PCTXOFlBXl.2 

check if transmit auto xoff enabled 

473 

018F 

75 

22 




JNE 

RECX 

I f not , go ex i t 

474 

01 C 1 

26 : 

: 6B 

46 

OO 


MOV 

AX,ES:RBCOUNT[BP] 

get count of chars in buffer again 

475 

01C5 

26 ; 

: 3B 

46 

02 


CMP 

AX , ES : RBMAXl BP] 

check if buffer now full 

476 

01C9 

74 

OC 




JZ 

REC9 

> if full see if xoff should be sent 

477 

01 C8 

26 : 

: 3B 

46 

08 


CMP 

AX , ES : RBXOFF [ BP ] 

check if over hi water mark 

478 

01 CF 

72 

1 2 




JB 

RECX 

> if not all done, go exit 

479 

0101 

F6 

47 

1 4 

04 


TEST 

BYTE PTR PCFLAGtBX] ,XMTXOF ; IF over hi water mark, but auto 

480 

0105 

75 

OC 




JNZ 

RECX 

>xoff already sent, then return 

48 1 

0107 





REC9 ; 



(attempt to send auto xoff comes here) 

482 






; %1% 

STI 


enable interrupts again 

483 

0107 

8A 

67 

2E 



MOV 

AH . PCXOFF 1 BX ] 

go send an xoff 

484 

01 DA 

E8 

01 F9 R 



CAL L 

AUTOXMT 


485 

0100 

74 

04 




JZ 

RECX 

If not sucessful go exit 

486 

01 OF 

80 

4F 

1 4 

04 


OR 

BYTE PTR PCFLAG [BX 1 , XMTXOF ; mark xoff sent by driver 

467 

01 E3 





RECX : 




488 






; 

STI 


enable interrupts 

489 

01 E3 

80 

7F 

1 7 

O 1 


CMP 

BYTE PTR PCRCVF[BX],1 

check if there is a routine to call 

490 

0 1 E7 

75 

OF 




JNE 

RCVX 

> exit if none (or one in progress) 

49 1 

01 E9 

FE 

47 

1 7 



INC 

BYTE PTR PCRCVF[BX] 

mark that a routine is being called 

492 

01EC 

FF 

5F 

1 8 



CALL 

DWORD PTR PCRCVA [ BX ] 

call service routine 

493 

01EF 

FE 

4F 

1 7 



DEC 

BYTE PTR PCRCVF[BX] 

mark that routine has returned 

494 

01 F2 

79 

04 




JNS 

RCVX 

check that its not cancelled 

495 

01 F4 

C6 

47 

1 7 

OO 


MOV 

BYTE PTR PCRCVF[BX],0 

If it has, reset value to tero 

496 

01 F8 

C3 




RCVX ; 

RET 


return to caller 


The Microsoft MACRO Assembler 
C0M6I0S 


487 

498 

499 

500 

501 

502 

503 

504 

505 

506 

507 
506 
506 
5 10 
51 1 

512 

513 
5 1 4 

515 

516 

517 

518 

519 


02-20-84 PAGE 

INTERRUPT SERVICE ROUTINES 


A U T 0 X M T 

This routine is used by the drivers to send the auto xon or x 
char act er s . 

This has to be a special routine because when a driver sends 
these control characters, different rules applies. 


ENTRY CONDITIONS: 


EXIT CONDITIONS; 


DS:BX points to port control block 
AH has the character to be transmitted 

2 set if character cannot be 

t r ansm i 1 1 ed 

Z cleared if it is sucessfully placed 

into the transmit buffer. 

OX, AX destroyed. 


520 

01 F9 




AUTOXMT ; 



521 

01 F9 

8B 

67 

1 2 

MOV 

OX , PCS7201 [BX ] 

get address of the 7201 status reg 

522 

01 FC 

9C 



PUSHF 


make sure interrupts are off 

523 





; % 1 % C L I 



524 

01 FD 

EC 



IN 

AL , OX 

check if transmit buffer empty 

525 

01 FE 

A8 

04 


TEST 

AL , 8IT2 


526 

0200 

74 

OF 


JZ 

L2 10$ 

> go exit if buffer not empty[ZF set 

527 

0202 

8A 

C4 


MOV 

alTah 

put the character in transmit buffer 

528 

0204 

22 

47 

1 6 

AND 

AL . PCMASKt 1 [BX] 

mask outgoing data 

529 

0207 

OA 

47 

15 

OR 

AL , PCMASK[ BX] 


530 

020A 

4A 



DEC 

OX 

(get address of data register) 

531 

020B 

4A 



DEC 

OX 

.(note Z is now cleared if) 

532 

020C 

EE 



OUT 

OX . AL 

. (OX not 8 2 ) 

533 

0200 

90 



POPF 


restore flags 

534 

020E 

OC 

80 


OR 

AL , BOH 

c 1 ear Z flag 

535 

0210 

C3 



RET 


return to caller 

536 








637 

02 1 1 

90 



12 10$: POPF 


rest ore f lags 

536 

0212 

32 

CO 


"■ XOR 

AL.AL 

return with x set 

539 

0214 

C3 



RET 


return to caller 
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A T X E M T 

Transmit buffer empty interrupt service for channel A, on the mother 
board . 


BX, OFFSET PCCOM 
SHORT TXBUFFER 


Port A transmit buffer empty 

get offset of the COMM port control block 

go to common routine to complete service 


X B T X E M T 

Transmit buffer empty interrupt service for channel A. or the mother 
board . 

BTXEMT: ; Port B transmit buffer empty 

MOV BX, OFFSET PCXCOM ; get the extended COMM port control block 

JMP SHORT TXBUFFER go to common routine for tranmit buffer empty 


Transmit buffer empty interrupt on port B, in the 7201 on the mother 
boar d . 


BX, OFFSET PCPRT 


BYTE PTR PCXMTFtBX],1 
TXBUFX 

BYTE PTR PCXMTFtBX] 
DWORD PTR PCXMTA tBX] 
BYTE PTR PCXMTFIBX] 
TXBUFX 

BYTE PTR PCXMTFIBX].© 
DX,PCS7201 [BX] 

AL , ENDTXBE 
DX , AL 


Port B transmit buffer empty 
get the printer port control block 
(Common code for all transmit buffer 
empty service interrupt) 
check if there is a routine to call 
> exit if none (or one in progress) 
mark that a routine is being called 
call service routine 
mark that routine has returned 
check that its not cancelled 
If it has, reset value to zero 
get control register address 
issue end of transmit buffer empty 

return to caller 


SPRECEIVE 

This is the common routine that is used to process the special receive 
character interrupt condition , for all 3 ports (port A and B on the 
7201 on the mother board, and port B on the extended comm port). 


ENTRY CONDITIONS; 


EXIT CONOITIONS; 


DS:BX points to the port control block 


; Port A (extended comm) special rev condition 
BX, OFFSET PCXCOM ; get the extended COMM pert control block 
SHORT SPREC ; go to common routine to handle it. 

; Port A (mother board) special rev condition 
BX, OFFSET PCCOM ; get offset of the COMM port control block 


DX , PCS7201 ( BX ] 
AL , DX 
AL , BIT1 
SPRECX 


DX,PCS7201 (BX] 


AH.AL ; save s 

AL.ERR7201 ; issue 

OX,AL ; 

AH , PARERR^0VRERR4-FRMERR 


get address of the 7201 status register 
read it . 

see if it's a special receive condition or: 
> go exit if its no interrupt pending, 
note that above check only necessary for 
port A on the 7201 

get address of the 7201 status register 

make sure interrupts are off 

set 7201 pointer to status register 1 

read status register 1 
now reenable them 
save status in AH 
issue error reset to 7201 


^RMERR ; keep parity, overrun, framing errors 

(this entry point is shared with end of break 
detect error) 

On entry DX points to st at us/eont r o 1 reg 
AH has the error flags set for the character 
now point to data register 


get the data from 7201 

go process character (in the same way as any 
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: other character) 

; return to caller. 
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645 

646 0268 C3 SPRECX: RET 


647 

648 

649 

650 

65 1 

652 

653 

654 

655 

656 

657 

658 

659 

660 

66 1 
662 

663 

664 

665 


667 

668 0269 

669 

670 

671 

672 0269 8B 57 12 

673 026C 86 C4 

674 026E 9C 

675 026F FA 

676 0270 EE 

677 0271 86 C4 

678 0273 EE 

679 0274 90 

680 0275 C3 



WRITE7201 ; 


MOV OX . PCS720U BX ] 

XCHG AL.AH 

PUSHF 
CL I 

OUT DX.AL 

XCHG AL.AH 

OUT DX.AL 

POPF 
RET 


common code to write to CONTROL REGISTER 3 

value to be written in AL 

DS:BX points to the PORT CONTROL BLOCK 

get status/control rag address of the 7201 
set pointer to correct control register 
make sure interrupts off 

now select the register number 
now write to the control register 
do it ! 

retore flags 
return to cal ler 


The Microsoft MACRO Assembler 
COMBIOS 


02-20-84 


PAGE 


21-1 


INTERRUPT SERVICE ROUTINES 


68 1 
682 

683 

684 

685 

686 

687 

688 


689 

0276 



690 

0276 

BO 

28 

69 1 

0278 

EB 

02 

692 




693 

027A 



694 

027A 

BO 

10 

695 




696 

027C 



697 

027C 

BA 

002A 

698 

027F 

EE 


699 

0280 

C3 


700 




701 

028 1 



702 

028 1 

BO 

30 

703 

0283 

E8 

027C 

704 




705 

0286 



706 

0286 

BA 

0028 

707 

0289 

EC 


708 

028A 

C3 



none of the follwoing conditions should ever happen; port not used 
But we' 11 service the interrupts per chance it happens. 


XATXEMT ; 

MOV AL^ENDTXBE 

JMP SHORT XAEXIT 


Port A transmit buffer empty 
send end TXE enterrupt 
go to common exit routine 


XASTAT : 

MOV AL.SX7201 


Port A external status change 
send status change acknowledged 


XAEX I T ; 


MOV 

OUT 

RET 


OX . 2AH 
OX . AL 


(common exit for 422 port ) 

; address of control register 

bye. and don't disturb again ! 


XARXSPC : 

MOV AL.ERR7201 

CALL XAEXIT 


Port A special receive condition 
send special condition clear 

(use exit code to write to crO only) 


XARXDAT : 

MOV DX.28H 

IN AL . DX 

RET 


Port A receive character available 

read the data 

drop it on the floor 
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709 

710 
7 1 1 
7 1 2 
7 1 3 
7 1 4 
7 1 5 
7 1 6 
7 1 7 
7 1 8 
7 1 9 

720 028B 

721 028B 

722 028E 

723 

724 0290 

725 0290 

726 0293 

727 

728 0295 

729 0295 

730 0298 

731 0298 

732 029B 

733 029C 

734 029E 

735 02A0 

736 02A1 

737 02A4 

738 

739 

740 

741 02A6 

742 02AA 

743 02AC 

744 02BO 

745 

746 02B2 

747 02B3 

748 

749 02B4 

750 02B6 

751 02B8 

752 02BA 

753 

754 

755 02BC 

756 02BC 

757 

758 

759 

760 

761 
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A S T A T 


X B S T 


External status change routines for al1 3 ports. These share a common 
routine XSTATCHC. These routines are included only to handle the case 
where break was detected. 


BB OOOO E 
EB 08 


BB OOOO E 
EB 03 


BB OOOO E 

8B 57 12 

EC 

8A EO 
BO 10 
EE 

F6 C4 80 
75 1 6 


F6 47 14 01 

74 14 

80 67 14 FE 

BO 01 

EE 

EC 

24 70 
OC 80 
8A EO 
EB A6 


80 4F 14 01 


MOV 

JMP 


MOV 

JMP 

ASTAT : 

MOV 

XSTATCHC : 

MOV 

IN 

MOV 

MOV 

OUT 

TEST 

JNZ 


TEST 

JZ 

AND 

MOV 

CL I 

OUT 

I N 

STI 

AND 

OR 

MOV 

JMP 


BK, OFFSET PCPRT 
SHORT XSTATCHC 


BX, OFFSET PCXCOM 
SHORT XSTATCHC 


BX. OFFSET PCCOM 

DX . PCS7201 I BX ) 
AL . DX 
AH . AL 
AL .5X7201 
DX . AL 
AH . B I T7 
XSTAT 1 


BYTE PTR PCFLACIBX 
XSTATX 

BYTE PTR PCFLACIBX 
AL .SRI 

DX , AL 
AL .OX 

AL . PARERR+OVRERR+F 
AL , BRKERR 
AH , AL 

SHORT SPREC1 


Port B external status change, mother board 
point to port control block 
go process external status change 

Port B external status change, extended comm 
; point to port control block 
go process external status change 

Port A external status change, mother board 

point to port control block 

go process external status change 

get address of 7201 status register 

read status 

save status 

reset external status change interrupt 
check if break is now on 

> if it is. go set flag in port control table 
If not, then first check if it was on before 
(if it was on and now off. then 
it must be the tail end of break) 
l.RCVBRK check in the port control table 

If it was never on. exit 
],NOT RCVBRK else, clear receive break flag 
read other error on the character 
make sure interrupts off 
first point to status register 1 
read the status 
reenable interrupts 

RMERR ; keep parity, overrun, framing errors 
set break detect error 

save it in AH (for common exit routines, 
go process character in the same way as 
special receive condition with the exception 
that this is a break character bit set 


BYTE PTR PCFLAGIBX] .RCVBRK ; If break detected for the first 
time, set the flag in the port control 
block, and wait till it goes away before 
forming the break character. 


; NOTE THAT INTERRUPTS ARE NOT ENABLED YET 
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782 






763 

02CO 





764 

02C0 

80 

7F 

21 

01 

785 

02C4 

75 

OF 



766 

02C6 

FE 

47 

21 


767 

02C9 

FF 

5F 

22 


788 

02CC 

FE 

4F 

21 


769 

02CF 

79 

04 



770 

02D 1 

C6 

47 

21 

oo 

771 

02D5 

C3 





INTERRUPT SERVICE ROUTINES 


XSTATX : 


CMP 

BYTE PTR 

PCSTCFIBX] . 1 

JNE 

L3 10$ 


INC 

BYTE PTR 

PCSTCF(BX) 

CALL 

DWORD PTR 

[ PCSTCA IBX] 

DEC 

BYTE PTR 

PCSTCFIBX] 

JNS 

L3 10$ 


MOV 

RET 

BYTE PTR 

PCSTCFIBX] .O 


Do the status change service call 
check if there is a routine to call 
> exit if none (or one in progress) 
mark that a routine is being called 
call service routine 
mark that routine has returned 
check that its not cancelled 
If it has. reset value to xero 
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772 

773 

774 

775 

776 

777 

778 

779 

780 
78t 

782 

783 

784 

785 

786 

787 

788 

789 

790 

791 

792 

793 

794 

795 

796 

797 

798 

799 

800 
801 
802 

803 

804 

805 
805 

807 

808 

809 

810 
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SUBTTL BIOS EXTENTION SERVICE ROUTINES 
P R C 7 2 O 1 

This is entry point to the BIOS to reprogram the 7201. It is also the 
interface to the initialize (soft and hard reset) the devices routines. 


ENTRY CONDITIONS: 


EXIT CONDITIONS: 


OS 

CX 

OX 


points to bios data area 

has the offset of the Comm Control Block 
has the segment of the Comm Control Block 


AL » FP programming device sucessful 
« O programming device unsucessful 


This routine will call many subroutines to perform each function in the 
r epr ogr ammi ng of the 7201. The convention used will be as follows: 


On entry to each subroutine. 


ES:BP points to CCB 

DS:BX points to Pert control block. 

CH device number (comm, printer etc) 

This is not to be altered by the 
cal 1 ing rout ines. 

CL set to FF if for some reason the 

request cannot be met. Also, the 
high order bit of the appropriate 
variable in the CCB is to be set. 

CL to be left untouched if request is 

sucessful 1y programmed. 

Initially CL is set to O by PRG7201. 


81 1 
812 

02D6 

02D6 

8E 

C2 


PRG7201 ; 

MOV 

ES.OX 

; set ES to have CCB segment address 

813 

02D8 

8B 

E9 


MOV 

BP . CX 

; point ES:BP to the CCB (comm control block) 

814 

020A 

26 

8A 

6E OO 

MOV 

CH.ES : IBP] 

; get port number 

815 

020E 

E8 

08 1 1 

R 

CALL 

GETPCB 

; call to get port control block for device 

816 

817 

818 

02E1 

72 

35 


JC 

PRGERR 

; > exit if port does not exist 

02E3 

B 1 

00 


MOV 

CL . 0 

; assume everything is ok 

819 

02EB 

E8 

03 IB 

R 

CALL 

STOPBIT 

; go program # of stopbits 

820 

02E8 

E8 

0342 

R 

CALL 

PARITY 

; go program parity 

821 

02EB 

E8 

03B6 

R 

CALL 

MODE 

; set mode, data leads or limited modem contri 

822 

02EE 

E8 

03E7 

R 

CALL 

DATABIT 

; go program # of data bits 

823 

02F1 

E8 

0450 

R 

CALL 

RCVBAUD 

set receiver baud 

824 

02F4 

E8 

04A1 

R 

CALL 

XMTBAUD 

; set transmit baud rate 
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B28 

02F7 

E8 

04PD R 



CALL 

XOHOFF 

set any new xon/xoff characters 

826 

02PA 

26 

8A 46 

09 


MOV 

AL.ES tCBRXOFlBPl 

see if auto receive xon/xof is changed 

827 

02PE 

22 

CO 



AND 

AL.AL 


828 

0300 

74 

03 



JZ 

PRGCM2 

> if not go on to next thing 

629 

0302 

88 

47 2F 



MOV 

PCRXOFIBX] . AL 

save new value (enabled/ or net) 

830 

0308 

26 

8A 46 

OA 

PRGCM2 

: MOV 

AL . ES :CBTX0FIBP] 

: check auto transmit xon/xoff 

831 

0309 

22 

CO 



AND 

AL . AL 

see if there is a change 

832 

030B 

74 

03 



JZ 

PRGCM3 

> If none, go on to next thing 

833 

0300 

88 

47 30 



MOV 

PCTXOF[BXl , AL 

Else save new value 

834 

0310 

E8 

0514 R 


PRGCM3 

: CALL 

BUFFER 

call routine to setup buffer usage 

835 

0313 

8A 

C 1 



MOV 

AL.CL 

pass return code in AL 

836 

0315 

34 

FF 



XOR 

AL.OFFH ; 

compliment return code (to correct value) 

837 

0317 

C3 




RET 


return to caller 

838 









839 

0318 

BO 

oo 


PRGERR 

: MOV 

AL.O 

indicate error 

840 

031A 

C3 




RET 

: 

return to caller 


The Microsoft MACRO Assembler 
COMB I OS 


84 1 
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843 

844 
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847 
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849 

850 

85 1 

852 

853 
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»*tm***»9» This has to be the first parameter to be programmed ******* 
S T 0 P B I T 

This routine is called to set up the number of stop bits. 


ENTRY CONDITIONS; 


EXIT CONDTIONS: 


DS : BX 
ES : BP 


points to the PORT CONTROL BLOCK 
points to the Comm Control Block 


Port control block updated. 


857 

031B 




STOPBIT : 



858 

031B 

26 

8A 

66 02 

MOV 

AH, ES :CB5TPB(BP) 

get parity from Comm Control Block 

859 

031F 

22 

E4 


AND 

AH, AH 

check if there is a change 

860 

0321 

74 

IE 


JZ 

L4 10$ 

> exit if no change 

861 

0323 

80 

FC 

03 

CMP 

ahTstpbmax 

check to see if in range 

862 

0326 

76 

08 


JBE 

L4 1$ 

If not in range, then 

863 

0328 

26 

80 

4E 02 80 

OR 

BYTE PTR ES:CBSTPBIBP) ,80H ; 

864 

032D 

B1 

FF 


MOV 

CL , OFFH 

indicate error 

865 

032F 

C3 



RET 


r et ur n to caller 

866 

0330 




L4 1$; 



867 

0330 

88 

67 

28 

MOV 

PCSTPB(BX) , AH 

save the value in Port Control Block 

868 

0333 

DO 

E4 


SHL 

AH, 1 

move it to correct value (for 7201) 

889 

0335 

DO 

E4 


SHL 

AH , 1 


870 

0337 

8A 

47 

OE 

MOV 

AL , PCCR4 ( BX ] 

get value programmed into CR4 

87 1 

033A 

24 

F3 


AND 

AL , OFFH-BIT3-BIT2 

clear loweer 2 bits 

872 

033C 

OA 

C4 


OR 

AL , AH 

set new mask 

873 

033E 

88 

47 

OE 

MOV 

PCCR4 [BX 1 , AL 

save new value for 7201 CR4 

874 








875 





; Note that 

value that goes into control 

register 4 is not yet put in! 

876 





; It will be 

done after parity is determined 


877 

878 


0341 C3 


L4_10$: RET 


; return to caller. 
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879 













880 


























882 













883 










P 

A R I T Y 


884 













888 








This 

rout 1 ne 

is callod 

to sot up tho parity. 

886 













887 









ENTRY 

CONDITIONS : 

OS:BX F 

toints to the PORT CONTROL BLOCK 

688 











ES:BP points to the Coram Control Block 

889 













890 









EXIT CONDTIONS: 

Port control block updated. 

89 1 











CL set tc 

FF if port control block has errors 

892 


























894 

0342 






i 

»ARITY 





898 

0342 

26 

80 

7E 

03 

OS 



CMP 

BYTE PTR 

ES:CBDATB[BP] ,5 

check to see if 7S or 7M asked for 

896 

0347 

72 

18 






JB 

LS 1$ 


> If not, program parity as requested 

897 

0349 

84 

03 






MOV 

AH , 3 


Else, force no parity 

898 

034B 

26 

38 

66 

04 




CMP 

BYTE PTR 

ES:CBPRTY[BP] . Af 

make sure no parity asked for 

899 

034F 

74 

32 






JZ 

L5 2$ 


> if so, go program the parity 

900 

0381 

26 

80 

7E 

04 

OO 



CMP 

BYTE PTR 

ES:CBPRTY[BP] .0 

or parity is not to be changed 

901 

0386 

74 

2B 






JZ 

L5 2$ 



902 

0388 

26 

80 

4E 

04 

80 



OR 

BYTE PTR 

ES : CBPRTY I BP ] , BOH ; Else mark parity request in error 1 

903 

0380 

B 1 

FF 






MOV 

CL . OFFH 


indicate error in CCB 

904 

03SF 

EB 

22 






JMP 

SHORT L5 

2$ 

then go program the parity 

90S 

036 1 







LS 1$ : 





906 

036 1 

26 

8A 

66 

04 




MOV 

AH . ES : CBPRTY IBP ] 

get parity from Comm Control Block 

907 

0365 

22 

E4 






AND 

AH . AH 


check if there is a change 

908 

0367 

74 

44 






JZ 

L5 15$ 


> exit if no change 

909 

0369 

80 

FC 

03 





CMP 

AH . 3 


if new parity is “NONE" then 

9 10 

036C 

74 

1 5 






JZ 

L5 2$ 


skip following validity check 

9 1 1 

036E 

26 : 

80 

7E 

03 

OO 



CMP 

BYTE PTR 

EStCBDATBlBP] .0 

; if parity is changed and. 

9 1 2 

0373 

75 

OE 






JNZ 

L5 2$ 


data bit also changed, go on 

9 1 3 

0375 

80 

7F 

29 

05 




CMP 

BYTE PTR 

PCDATBIBX] , 5 

else, parity changed and data bit not 

9 1 4 

0379 

72 

E6 






JB 

L5 1$ 


and old data bit is 7S or 7M 

9 1 5 

037B 

26 : 

: 80 

4E 

04 

80 



OR 

BYTE PTR 

ES : CBPRTY I BP ], BOH ; mark parity request in error 

9 1 6 

0380 

8 1 

FF 






MOV 

CL , OFFH 


indicate error in CCB 

9 1 7 

0382 

C3 







RET 



and return to caller 

918 













9 1 9 

0383 






1 

LS_2$ : 





920 

0383 

80 

FC 

03 





CMP 

AH . PRTYMAX 

see if its in range 

921 

0386 

76 

08 






JBE 

L5 3$ 


If not then. 

922 

0388 

26 

: 80 

4E 

04 

80 



OR 

BYTE PTR 

ES : CBPRTY I BP 1 , BOH ; 

923 

0380 

B 1 

FF 






MOV 

CL , OFFH 


set error return code 

924 

038F 

C3 







RET 



r et ur n to ca 1 1 er 

925 

0390 







LS_3$ : 





926 

0390 

88 

67 

2A 





MOV 

PCPRTYlBXl ,AH 

save the value in Port Control Block 

927 

0393 

32 

CO 






XOR 

AL . AL 


assume its no parity 

928 

0395 

80 

FC 

03 





CMP 

AH . 3 


transform value from CCB as follows: 

929 

0398 

74 

08 






JZ 

L5 13$ 


(CCB value, CR4 value) 

930 

039A 

BO 

03 






MOV 

AL , 3 


even (1,3); Odd (2,1); none (3.0) 

931 

039C 

FE 

cc 






OEC 

AH 
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932 

039E 

74 

02 



JZ 

L5 13$ 


933 

03A0 

BO 

0 1 



MOV 

alTi 


934 

03A2 




L5__1 3$ ; 



(now mask correct for 7201 cr4) 

935 

03A2 

8A 

67 

OE 


MOV 

AH . PCCR4 [ BX ] 

get value programmed into CR4 

936 

03A5 

80 

E4 

FC 


AND 

AH , NOT ( B I TO+B IT 1 ) 

clear lower 2 bits 

937 

03A8 

OA 

C4 



OR 

AL , AH 

set new mask 

938 

03AA 

88 

47 

OE 


MOV 

PCCR4 { BX ] . AL 

save new value for 7201 CR4 

939 

03AD 




L5_1 5$ : 



(common exit path to set CR4, note 

940 








that this must always be done!) 

94 1 

O3A0 

8A 

47 

OE 


MOV 

AL , PCCR4 I BX ] 

get value to be programmed to CR4 

942 

03B0 

B4 

04 



MOV 

AH , CR4 

go to common routine to programm 7201 

943 

03B2 

E9 

0269 R 


JMP 

WRITE7201 

(and return to caller when done) 

944 

03B5 

C3 




RET 


return to caller. 
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945 


946 


947 


948 


949 


950 


951 


952 


953 


954 


955 


956 


957 


958 


959 


980 


96 1 

03B6 

9 82 

03B6 

963 

03BA 

964 

03BC 

965 

03BE 

966 

03C 1 

967 

03C3 

968 

03C8 

989 

03CA 

970 

03CB 

971 

03CB 

972 

03CE 

973 

03D0 

974 

03D2 

975 

03D4 

976 

03D6 

977 

03D6 

978 

03D9 

979 

03DC 

980 

03DE 

981 

03E 1 

982 

03E3 

983 


984 

03E6 


28: 8 A 66 01 

22 E4 
74 28 

80 PC 02 
76 08 

26: 80 4E 01 80 

81 FF 
C3 

88 67 27 

32 CO 
FE CC 
74 02 
80 20 

8A 67 OD 
80 E4 OF 
OA C4 
88 47 OD 
84 03 
E9 0269 R 

C3 


This routine is coiled to set up the mode, dote leads or limited 
modem control . 


ENTRY CONDITIONS; 


EXIT CONOTIONS: 


OS : BX 
ES : BP 


points to the PORT CONTROL BLOCK 
points to the Comm Control Block 


Port control block updated. 


MOV AH . ES : CBMODE[BP ] 

ANO AH, AH 

J2 MODEX 

CMP AH.MOOEMAX 

JBE L6_1$ 

OR BYTE PTR ES : CBMODE I BP ] , 80H 

MOV CL.OFFH 

RET 


get the mode from Comm Control Block 
check if there is a change 
> exit if no change 
check if its in range 
i f not then, 

set error return code 
return to caller 


MOV 

XOR 

OEC 

JZ 

MOV 

MOV 

AND 

OR 

MOV 

MOV 

JMP 


PCMODEIBXI , AH 
AL . AL 
AH 

MODE 1 
AL , 20H 

AH,PCCR3[BX] 
AH.OFFH-BITS 
AL , AH 

PCCR31 BX ] . AL 
AH . CR3 
VfRlTE7201 


save the value in Port Control Block 
assume its data leads only 
check if its data leads 
> i f so go program 7201 

Else assume its limited modem control 

get old value in 7201 CR3 
clear the bit that programs this 
set new value 
save new value 

go to routine to program 7201 
go do i t . 


MODEX: RET 


return to caller. 
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This r out i ne 

ENTRY CONDITIONS: 

EXIT CONDTIONS: 


D A T A B I T 

s called to set up the number of data bits 


DS : BX 
ES : BP 


points to the PORT CONTROL BLOCK 
points to the Comm Control Block 


Port control block updated. 


998 







999 

03E7 



DATAB IT 



1000 

03E7 

26 : 

8A 66 03 


MOV 

AH . ES : CBDATB [ BP ] 

100 1 

03EB 

22 

E4 


AND 

AH . AH 

1002 

03ED 

74 

60 


JZ 

DATABX 

1003 

03EF 

80 

FC 06 


CMP 

AH . DATMAX 

1004 

03F2 

76 

08 


JBE 

L7 10$ 

1005 

03F4 

26 : 

80 4E 03 80 


OR 

BYTE PTR ES:CBDATB 

1006 

03F9 

B 1 

FF 


MOV 

CL , OFFH 

1 007 

03FB 

C3 



RET 


1008 

03FC 



L7 10$: 



1009 

03FC 

88 

67 29 


MOV 

PCDATB ( BX ] , AH 

1010 

03FF 

32 

CO 


XOR 

AL . AL 

101 1 

0401 

BA 

1FOO 


MOV 

DX , 1 FOOH 

1012 

0404 

FE 

CC 


OEC 

AH 

1013 

0406 

74 

20 


JZ 

L7 1$ 

1014 

0408 

BO 

40 


MOV 

AL . 40H 

1015 

040A 

B6 

3F 


MOV 

DH . 3FH 

10 16 

040C 

FE 

CC 


OEC 

AH 

1017 

040E 

74 

1 8 


JZ 

L7 1$ 

1018 

04 10 

BO 

20 


MOV 

AL . 20H 

1019 

0412 

B6 

7F 


MOV 

DH , 7FH 

1020 

0414 

FE 

CC 


DEC 

AH 

102 1 

04 1 6 

74 

10 


JZ 

L7 1$ 

1022 

04 1 8 

BO 

60 


MOV 

AL , 60H 

1023 

04 1 A 

B6 

FF 


MOV 

DH , OFFH 

1024 

04 1 C 

FE 

CC 


DEC 

AH 

1025 

041 E 

74 

08 


JZ 

L7_1$ 

1026 







1027 




; 7M or 

7S i s 

done by programming ' 

1028 







1029 

0420 

B6 

7F 


MOV 

DH . 07FH 

1030 

0422 

FE 

CC 


DEC 

AH 

103 1 

0424 

74 

02 


JZ 

L7 1$ 

1032 

0426 

B2 

80 


MOV 

DL . 80H 

1033 

0428 



L7__1$ : 



1034 

0428 

50 



PUSH 

AX 

1035 

0429 

89 

57 15 


MOV 

PCMASK(BX ] . DX 

1036 

042C 

8A 

67 OF 


MOV 

AH . PCCR5 [ BX 1 

1037 

042F 

80 

E4 9F 


ANO 

AH. NOT (BIT6+BIT5) 


# data bit from Comm Control Block 
check if there is a change 
> exit if no change 
check if its above maximum 
If not then 
, BOH ; indicate error in # of databits 

set error code 
; return to caller 


save the value in Port Control Block 
get register value for 5 data bits 
get data mask for 5 data bit 
If so go to it (CCB value 1) 

> go program 7201 
next assume its 6 data bits 
(masks AND 3F , OR OO ) 

(CCB value 2) 

> If it is go program 7201 
next assume its 7 data bits 

(mask AND 7F . OR OO ) 

If it is then go program 7201 
next assume its 8 bits 

(mask AND FF . OR OO ) 

> If so go program 7201 


(mask AND 7F) 
assume its 7 space 
> If so. go program 7201 
Else it must be 7M ( mask OR 80] 

save value for # data bits in receive 
save new mask 

get old value in control register 5 
clear bits for "data bits per byte” 
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1030 

0432 

OA 

C4 


OR 

AL . AH 

put 

1 n 


1030 

0434 

00 

47 

OF 

MOV 

PCCRStBXl . AL 

save It In the port control block 

1040 

0437 

B4 

05 


MOV 

AH.CR5 

sot 

to 

go to routine to program 7201 

1041 

0430 

EO 

0200 R 

CALL 

WRITC7201 

go 

do 

It . 

1042 

043C 

50 



FOP 

AX 

got 

# 

stop bits for receive chars 

1043 

0430 

DO 

CO 


SHL 

AL . 1 

put 

It 

in correct place for 7201 

1044 

043F 

OA 

87 

OD 

MOV 

AH. PCCR3IBX I 

got 

old valuo In control register 5 

1045 

0442 

00 

C4 

3F 

AND 

AH. NOT (BIT7-(>BIT0) 

c loor 

bits for "data bits per byte" 

1040 

0445 

OA 

C4 


OR 

AL . AH 

put 

1 n 

new value for # data bits 

1047 

0447 

00 

47 

OD 

MOV 

PCCR3[BXl . AL 

save It In tho port control block 

1040 

044A 

B4 

03 


MOV 

AH. CR3 

sot 

to 

go to routine to program 7201 

1040 

044C 

EO 

0200 R 

JMP 

WR1TE7201 

go 

do 

it . 

10S0 










10S1 

044F 

C3 



DATABX: RET 


rot urn 

to caller. 
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1052 











1053 






















1055 











lose 









R C V B 

A U 0 

1057 











1054 







Th i s rout i ne 

is called to reprogram the receiver baud rate 

1059 











1060 











106 1 








ENTRY 

CONOITIONS : 

OS:BX points to Pert Control Block 

1062 










AL has value from Comm control block 

1063 










CH device number 

1064 











1065 








EXIT CONOITIONS: 

CL : FF device cannot be programmed as requested 

1066 










HO bit in the CCB is set to 1 in the receive 

1067 










baud rate variable. 

1066 










otherwise CL is left untouched 

1069 






















107 1 

0450 






tCVBAUO ; 




1072 

0450 

26 

6A 46 

05 




MOV 

AL , ES : CBRCVB[ BP ] 

get new baud rate to be programmed 

1073 

0454 

22 

CO 





ANO 

AL . AL 

; see if there is any change in rev baud 

1074 

0456 

74 

2A 





JZ 

RCVBX 

; > exit if not 

1075 

0456 

E6 

04E1 R 





CALL 

GETBAUO 

; get the value to be written to generator 

1076 

0456 

3C 

FF 





CMP 

AL , OFFH 

: check if the value is legal 

1077 

0450 

75 

06 





JNZ 

RCVB1 

; If not legal then 

1076 

045F 

B1 

FF 





MOV 

CL. OFFH 

; indicate programming failed 

1079 

0461 

26 

60 4E 

05 

60 



OR 

BYTE PTR ES : CBRC VB I BP ] , 60H mark the receive baud rate as not supported 

1060 

0466 

C3 






RET 


; and return to caller 

1061 

0467 






tCVB 1 : 




1062 

0467 

60 

FO 02 





CMP 

CH , DEVPRT 

; if the device is the printer skip following 

1063 

046A 

74 

1 7 





JZ 

RCVBPRT 

; treat it as special case 

1064 

046C 

26 : 

: 6A 66 

05 




MOV 

AH . ES : CBRCVBC BP ] 

; get new baud rate to be programmed 

1065 

0470 

66 

67 2B 





MOV 

PCRCVB[ BX ] . AH 

; save it in port control block 

1066 

0473 

6A 

6 7 OA 





MOV 

AH . PCRATE f BX] 

; get old value 

1067 

0476 

60 

E4 FO 





ANO 

AH , OFOH 

; save transmit baud rate portion 

1066 

0479 

OA 

C4 





OR 

AL , AH 

; get new baud rate value (both xmt 6 rev) 

1069 

0476 





1 

RCVB2 : 




1090 

0476 

66 

47 OA 





MOV 

PCRATE I BX 1 . AL 

; save the new value 

109 1 

047E 

6B 

57 06 





MOV 

OX,PCBAUO[BX] 

; get port address of baud rate generator 

1092 

0461 

EE 






OUT 

OX. AL 

; do it* 

1093 

0462 






RCVBX : 




1094 

0462 

C3 






RET 



1095 











1096 







printer is a 

special case at this point we Know that receive baud rate 

1097 







is non zero 

and is valid 


1096 











1099 

0463 





1 

RCVBPRT 




1 100 

0463 

26 

: 6A 46 

OS 




MOV 

AL .ES -.CBRCVBIBP: 

get new baud rate to be programmed 

1101 

0467 

26 

: 60 7E 

06 

00 



CMP 

BYTE PTR ES :CBTXBIBP] .0 ; if xmt baud not specified 

1 102 

046C 

75 

05 





JNZ 

L6 5$ 

; then 

1 103 

046E 

26 

: 66 46 

06 




MOV 

ES : CBTXB[BP] . AL 

; make transmit baud * rev baud 

1 104 

0492 

C3 






RET 


; return to caller 
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1 10B 
1 106 

0493 

26 : 

: 36 

46 

06 

L8_6$; 

CMP 

ES : CBTXBIBP] , AL 

if xrat baud is the same as 

1 107 

0497 

74 

07 




J2 

L8_10$ 

rev baud then return 

1 108 










1 109 

0499 

26 : 

: 80 

4E 

05 80 


OR 


, 80H : Else marK error in CCB 

1 1 10 

049E 

B1 

PF 




MOV 

CL . OFFH 

for receive baud 

1111 

1112 

04A0 

C3 




L8_10$ 

; RET 


return to cal ler 
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1113 

1114 


1116 

1117 

1118 
1119 
1 1 20 
112 1 
1 1 22 
1 1 23 
1 124 
1 1 25 
1 128 
1 1 27 
1 128 
1 129 
1 130 
1131 
1 1 32 
1 1 33 
1 1 34 





XMTBAUD 

This routine is called to reprogram the transmit baud rate. This routine 
is never called for the printer transmit baud rate change. The next level 
routine above this will determine if the printer has to be reprogrammed 
and will call RCVBAUD; since transmit and receive baud rates must be the 
same in the printer. 

ENTRY CONDITIONS: DS ; BX points to Port Control Block 

ES : BP points to comm control block 

CH device number 

EXIT CONDITIONS: CL = FF device cannot be programmed as requested 

HO bit in the CCB is set to 1 in the receive 
baud rate variable, 
otherwise CL is left untouched 










1136 

04A1 



XMTBAUD 




1 1 37 

04A 1 

26 

8A 46 06 



MOV 

AL , ES : CBTXB I BP ] 


1 1 38 

04A5 

22 

CO 



AND 

AL . AL 

check to see if there is a change 

1 1 39 

04A7 

74 

37 



JZ 

XMTBX 

> exit if there is no change 

1 1 40 

04A9 

E8 

04E 1 R 



CALL 

GETBAUD 

get the value to be written to generator 

114 1 

04AC 

3C 

FF 



CMP 

AL . OFFH 

If its bad value then. 

1 142 

04AE 

75 

08 



JNZ 

XMTBO 


1 143 

04B0 

B1 

FF 



MOV 

CL .OFFH 

set return code 

1 144 

04B2 

26 

80 4E 06 80 



OR 

BYTE PTR ES : CBTXB [ BP ], 80H indicate tranroit baud rate in error 

1 145 

04B7 

C3 




RET 


and return to caller 

1146 

04B8 



XMTBO : 




1 147 

04B8 

26 : 

: 8A 66 06 



MOV 

AH.ES:CBTXB[BP] 

save new value from CCB to the Port control block 

1 148 

04BC 

86 

67 2C 



MOV 

PCTXB I BX ] , AH 


1 149 

04BF 

80 

FO 02 



CMP 

CH . DEVPRT 

If its printer then. 

1 1 50 

04C2 

75 

OS 



JNZ 

L9 1$ 


115 1 

04C4 

88 

67 2B 



MOV 

PCRCVB [ BX ] , AH 

mark printer rev baud same as xmt baud 

1 152 

04C7 

EB 

10 



JMP 

SHORT L9 4$ 

> skip rest (programming generator different) 

1 153 

04C9 



L9 1$ : 




1 154 

04C9 

8A 

67 OA 



MOV 

AH . PCRATE I BX ] 

get old value programmed into generator 

1 155 

04CC 

80 

E4 OF 



AND 

AH . OFH 

save receive baud rate portion 

1156 

04CF 

OO 

EO 



SHL 

AL . 1 

move value to ho nibble 

1 157 

04D1 

oo 

EO 



SHL 

AL , 1 

.(CL not to be touched) 

1 158 

0403 

OO 

EO 



SHL 

AL . 1 


1 159 

0405 

00 

EO 



SHL 

AL . 1 


1 1 60 

0407 

OA 

C4 



OR 

AL , AH 

get the new baud rate value to be programmed 

il 1 61 









p 1 62 

0409 

88 

47 OA 

L9 4$ : 

MOV 

PCRATEEBX] . AL 

save new value into the port control block 

1 1 63 

040C 

8B 

57 08 



MOV 

OX , PCBAUDI BX ] 

get port address of baud rate generator 

1 1 64 

O40F 

EE 




OUT 

OX. AL 

do it • 

1 1 65 

04E0 



XMTBX : 
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1 1 67 
1 1 68 
1 1 69 
1 1 70 

117 1 
1 1 72 
1 173 
1 1 74 
1 1 75 
1 176 
1 1 77 
1 1 78 
1 1 79 
1 1 80 

118 1 
1 1 82 
1 1 83 
1 184 
1 1 85 
1 186 
1 1 87 
1 188 
1 189 


1 190 

04E 1 



119 1 

04E 1 

3C 

OO 

1192 

04E3 

72 

15 

1193 

04E5 

3C 

1 1 

1194 

1195 

04E7 

77 

1 1 

1196 

04E9 

53 


1197 

04EA 

BB 

OOOO E 

1198 

04ED 

80 

FO 02 

1199 

04F0 

75 

03 

1 200 

04F2 

BB 

OOOO E 

1 201 

04F5 



1 202 

04F5 

FE 

C8 

1 203 

04F7 

D7 


1 204 

04F8 

5B 


1 205 
1 206 

04F9 

C3 


1 207 

04FA 

BO 

FF 

1 208 

04FC 

C3 



02 >20-84 PAGE 30* 1 

BIOS EXTENTION SERVICE ROUTINES 


C E T B A U D 

This routine is used to get the value to be that the generator is 
to be programmed corresponding to the baud rate value specified in 
the Comm control blocK. 


ENTRY CONDITIONS; 


EXIT CONDITIONS: 


DS:BX points to port control block 
it is assumed that it resides 
in the same segment address a: 
the translate tables. 

CH device number 

AL new baud rate value 


AL 

AL 


has the value to be written 
the baud rate generator 
FF this baud rate no supported 


CETBAUD ; 


CMP AL.O 

JB L34 10$ 

CMP AL.BAUOMAX 

JA L34 10$ 


check range 

> If out of range indicate bad 


baud 


PUSH BX 

MOV BX, OFFSET XBAUD1 

CMP CH.DEVPRT 

JN2 L34__1$ 

MOV BX, OFFSET XBAU02 

L34 1$; 

” DEC AL 

XLAT XBAUD1 

POP BX 

RET 


save BX, for translation 

assume its printer port 

see if its the printer 

> If so go do table lookup 

Else point to table for Comm 8 Xcomm 

table starts at O ( 1 in ccb) 
translate value 
restore register 
r at ur n to caller. 


L34 10$; MOV AL,OFFH 

~ RET 


out of range, indicate bad value 
return to caller 
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This routine is used to setup the characters to be used in the 
xon/xof f protocol . 

Note that the protocol is ttie same, as a standard xon/xof f, and that 
the only change allowed is which character can be used to perform 
this. 


ENTRY CONDITIONS: 


points to port control block 
it is assumed that it resides 
in the same segment address as 
the translate tables, 
device number 
Comm control block 


EXIT CONDITIONS: 


AL . ES : CBXON { BP ] 
AL . AL 
xonof 1 

PCXON I BX ] . AL 
AL , ES : CBXOFF I BP 1 
AL . AL 
XONOFX 

PCXOFF t BX ] , AL 


get new xon character 
check if there is a change 

> if not, go check xoff 
save new xon character 
got new xoff character 
check if there is a change 

> go exit if no change 
save new value 

r et ur n to caller 


This routine is called to calculate the buffer control information. 


ENTRY COND I T I ONS : 


OS:BX points to port control block 

ES:BP points to Comm control block 


EXIT CONDITIONS: 


FF If unsucessful (buffer area too small) 
left alone otherwise. 


AX , ES : CBS I ZE I BP ] ; check new size of buffer 

AX , AX ; If its zero, exit 

BUFFX ; 

AX , RBLEN+2* ( RBDFLT ) ; check if its > default size 

BUFFI ; If not then, 

CL,OFFH ; set return code 

WORD PTR ES : CBS I ZE [ BP ] , BOH ; indicate offending variable 

SHORT BUFFX go return to caller 


AND AL,OFEH ; round down to even number 

LES SI, DWORD PTR ES : CBRADR [ BP ] ; get address of the buffer 

now calculate and enter all the buffer control information 


diable interrupts first 

This is an embedded entry point 
for INITCOM, used when the default 
buffer is set up 

( ES:SI point to buffer area ) 

DS:BX points to port control block 
AX has the size of the buffer 


First clear all flags related to xon/xoff, since we now have a new buffer 

AND BYTE PTR PCF L AG t B X 1 , NOT ( XMTXON+XMTXOF+RCVXOF+APPXOF ) 

MOV PCS I ZE ( BX 1 , AX ; save size of new buffer 

MOV PCRAOR [ BX ] , S I ; save new offset to buffer 

MOV PCRADR+2 C BX ] , ES ; save segment address of new buffer 

SUB AX.RBLEN , subtract buffer space from buffer 


DX , RBLEN 
ES: RBINlSI ] , DX 
ES : RBDUT [SI ] , DX 
ES : RBHEAD [SI ] . DX 
DX . AX 
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128S 

0586 

4A 




DEC 

OX 

; (want address of tha last word 

1298 

0587 

4A 




DEC 

OX 

; of the buffer) 

1297 

1298 

0556 

26 : 

69 

54 

OE 

MOV 

ES :RBTAILtSI ] .OX 

; put address into buffer control info 

1299 

055C 

01 

E6 



SHR 

AX . 1 

; divide by 2 to get max number chars 

1300 

055E 

26 : 

69 

44 

02 

MOV 

ES : RBMAXtSI ] .AX 

save new value 

1301 

1302 

0562 

26: 

C7 

04 

OOOO 

MOV 

WORD PTR ES : RBCOUNTISI ] 

o : put indicate no characters in buffer 

1303 

0567 

01 

E6 



SHR 

AX. 1 

: xoff threshold is buffer half full 

1304 

0569 

26 : 

69 

44 

08 

MOV 

ES : RBXOFFISI 1 .AX 

; save calculated xoff threshold value 

1305 

0560 

01 

E6 



SHR 

AX . 1 

: calcuate auto xon threshold (1/4 of 

1306 

056F 

01 

E6 



SHR 

AX . 1 

; xoff threshold) 

1307 

0571 

26 : 

89 

44 

OA 

MOV 

ES : RBXONISI ] .AX 

save value. 

1308 

0875 

80 




POPP 


: restore user flags 

1309 

1310 

0576 

C3 




BUFFX: RET 
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13 11 
1312 


1313 

1314 

1315 
13 16 
13 17 

1318 

1319 

1320 

1321 

1322 

1323 
1 324 




D F L T 7 2 0 1 

This routine is called to reprogram a particular device to the default 
value. 

ENTRY CONDITIONS: CH device number 

D5 points to bios data area 










1326 









1327 

0577 


DFLT7201 ; 





1328 

0577 

E8 

09 11 R 

CALL 

GETPCB 


; 

check if port is present 

1329 

OS7A 

72 

3C 

JC 

L10 10$ 


; 

> exit if not 

1330 

057C 

E8 

OSB9 R 

CALL 

OFLTBUF 


; 

call routine to setup default receive 

1331 








char buffer (and get address of pcb) 

1332 









1333 

057F 

E8 

07DF R 

CALL 

RCVCANCEL 


; 

cancel rev interrupt service 

1334 

0582 

E8 

08 19 R 

CALL 

XMTCANCEL 


; 

cancel xmt buffer empty service 

1 335 

0585 

E8 

OOOO E 

CALL 

RONVMCOM 


; 

go read NVM for default comm values 

1336 









1 337 

0588 

51 


PUSH 

CX 


; 

save device number 

1338 

0589 

8B 

4F 04 

MOV 

CX . PCOFLT(BX) 


; 

get address of default settings (CCB) 

1339 

OS8C 

80 

4F OE 40 

OR 

BYTE PTR PCCR4( 

BX) . 

CLK1 6X 

; make sure its 1 6X for clock divisor 

1340 

0590 

8C 

DA 

MOV 

OX. OS 


; 

set segment of CCB to bios data area 

1341 

0592 

E8 

0206 R 

CALL 

PRG7201 


; 

go reprogram 7201 to default values 

1342 

0595 

59 


POP 

CX 


; 

restore device number 

1343 









1344 

0596 

C6 

47 14 OO 

MOV 

BYTE PTR PCFLAG[BX] 

. O ; 

clear all flags 

1345 









1346 

059A 

8A 

47 OF 

MOV 

AL . PCCR5(BX) 


; 

enable transmitter (note that at this 

1347 

059D 

OC 

08 

OR 

AL . 08 


; 

point the port is guaranteed to 

1348 

059F 

88 

47 OF 

MOV 

PCCR5 (BX ] . AL 


; 

be present, so it is ok to 

1349 

05A2 

B4 

05 

MOV 

AH , CR5 


; 

write to the device 

1 350 

05A4 

E8 

0269 R 

CALL 

WRITE7201 


; 


1351 

05A7 

E8 

05EA R 

CALL 

RCVENA 


; 

enable the receiver 

1352 









1353 

05AA 

BO 

10 

MOV 

AL . SX7201 




1354 

05AC 

8B 

57 12 

MOV 

OX , PCS7201 (BX) 




1355 

05AF 

EE 


OUT 

OX , AL 




1356 









1357 

05B0 

8A 

47 OB 

MOV 

AL , PCCR1 [BX] 

now set 

register 1 before anything else 

1358 

05B3 

B4 

oi 

MOV 

AH. CR1 

; 



1359 

05B5 

E8 

0269 R 

CALL 

WRITE7201 

; 



1360 









1361 

05B8 

C3 


L10_10$ : 

RET 
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1362 

1363 

1364 

1365 

1366 

1367 
1366 

1369 

1370 

1371 

1372 

1373 

1374 
1 376 
1 376 
1 377 
1376 


1379 

06B9 



1 360 

06B9 

E8 

09 1 1 

1 38 1 

06BC 

73 

oi 

1 362 

06BE 

C3 


1363 




1364 

06BF 

IE 


1365 

06C0 

07 


1366 

05C1 

60 

77 3 

1367 

05C4 

B8 

0060 

1 366 

06C7 

E9 

053 1 


1 369 


D F 

This rout ins is callsd to 
dofault buf for . 

ENTRY CONDITIONS: 

EXIT CONDITIONS: 


L T 6 U F 

reset receive character buffer area to the 

CH has device number 

command ignored if port number invalid 

DS:BX points to port control block 
buffer pointer reset. 


DFLTBUF : 

CALL CETPCB 
JNC L11 1$ 
RET “ 


get address of port control block 
if port number invalid, 
return to caller 


L 


$: PUSH DS 

POP ES 

LEA SI.PCLENtBX] 

MOV AX , RBLEN<^2»RBDFLT 

JMP BUFF10 


point ES to bios data area too 
.(where default ccb is) 
get the address of default buffer 
get siie of default buffer 
go reset buffer control information 
then return to caller 
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139 1 

1392 

1393 
1 394 
1 396 

1396 

1397 
1396 
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R D S E T U P 

This routine is called to retreive the information that is programmed 
into the specified port. 


1399 

1400 

1401 
1 402 

1403 

1404 
1406 
1406 




ENTRY 

EXIT 

CONDITIONS: CX.DX contains of f set , segment of CCB 

first byte of CCB must have 
port number 

CONDITIONS: AL s O port information loaded 

AL = FF invalid port number, or port 
not connected. 

1406 

1409 

06CA 

05CA 

6B 

E9 

tOSETUP : 

MOV 

BP . CX 

point ES:BP to comm control block 

1410 

05CC 

6E 

C2 

MOV 

ES. OX 


14 11 

06CE 

26 : 

6A 6E 'OO 

MOV 

CH.ES : [BPl 

get port number 

1412 

05D2 

32 

CO 

XOR 

AL . AL 

assume invalid port address 

1413 

06D4 

E6 

09 11 R 

CALL 

GETPCB 

get address of port control block (DS:BX) 

1414 

06D7 

72 

10 

JC 

L12 10$ 

> exit if bad port number or not connected 

1415 

06D9 

63 

C3 27 

ADD 

BX .PCMOOE 

point to beginning of Port control block 

1416 

1417 

O60C 

8B 

F3 

MOV 

SI . BX 

that matches comm control block 
get ready to transfer 

1416 

05DE 

B9 

0010 

MOV 

CX . CBLEN- 1 

transfer the whole table minus port number 

1416 

05E1 

6B 

FO 

MOV 

01 . BP 

get destination offset into DI 

1420 

06E3 

47 


INC 

01 

point DI passed port number 

142 1 

1422 

1423 

06E4 

06E6 

FC 

F3/ 

A4 

CLO 

REP 

MOVSB 

get the correct direction 
move whole string 

1424 

1425 

05E7 

BO 

FF 

MOVSB 

MOV 

AL ,OFFH 

indicate information sucesfully passed 

1426 

1427 

05E9 

05E9 

C3 

L12 10$: 

RET 


r et ur n to caller 
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1428 
1 429 
1430 
1 43 1 
1 432 
1 433 
1 434 
1 435 
1 436 
1 437 
1 438 
1 439 
1 440 
1 44 1 
1442 
1 443 
1 444 
1 446 
1 446 
1 447 
1 448 
1 449 
1 450 
1 45 1 
1 452 
1 453 
1 454 
1 455 
1 456 
1 457 
1 458 
1 459 
1460 
146 1 

1462 

1463 

1464 

1465 

1466 

1467 

1468 

1469 
1 470 
1 47 1 
1 472 
1473 
1 474 
1 475 
1 476 


05EA 
05EA E8 
05ED 73 
06EF C3 
05F0 

05F0 8A 
06F3 OC 
05F5 80 

05F9 EB 


05FB 

05FB E8 
05FE 73 

0600 C3 
060 1 

0601 8A 

0604 24 

0606 80 

060A 

060A 88 

0600 B4 
060F E9 


09 11 R 

oi 


47 00 
O 1 

67 14 OF 

OF 


09 11 R 
OI 


47 OD 
FE 

4F 14 20 


47 OD 
03 

0269 R 


R C V E N A 

This routine is celled to enable the receiver. 

ENTRY CONOITIONS: CH device number 

EXIT CONDITIONS: Command ignored if port is inviaid 


RCVENA : 

CALL 

JNC 

RET 

L 1 3_1$ : 

MOV 

OR 

AND 

JMP 


GETPCB 
L 1 3 1 $ 


get port control bicok address 
If port number is inviaid then, 
return to caller 


AL,PCCR3[BX] : read last value put into control register 3 

AL.BITO ; enable receiver 

BYTE PTR PCFLAGIBX] ,OFFH-RCVOFF ; set flag that receiver is enabled 
SHORT RCVCOMMON ; go use common code for disable 8 enable 


R C V D I S 

This routine is called to disable the receiver. 

ENTRY CONOITIONS: CH device number 

EXIT CONDITIONS: Command ignored if port is inviaid 


CALL GETPCB 

JNC L14_1$ 

RET 

MOV AL,PCCR3[BX] ; get last value put into control register 3 

AND AL,OFFH-BITO ; clear last bit 

OR BYTE PTR P C F L A G I B X J . R C V 0 F F ; set flag that receiver is disabled 


porx control dicok aaaress 
if port number invalid then, 

> return to caller 


RCVCOMMON : 

MOV PCCR3 { BX ] , AL 

MOV AH,CR3 

JMP WRITE7201 


restore CR3 
write it to 
go write it 


value in port control block 
control register 3 
to the control register 
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1477 
1 478 
1479 
1 480 

148 1 
1 482 
1 483 
1 484 
1 485 
1486 
1 487 
1 488 
1 489 
1490 

149 1 
1 492 
1 493 


494 

0612 



495 

0612 

32 

CO 

496 

06 1 4 

E8 

09 11 R 

497 

06 1 7 

72 

OC 

498 

0619 

C4 

5F 33 

499 

06 1 C 

26 : 

: 8B 07 

500 

06 1 F 

23 

CO 

501 

062 1 

74 

02 

502 

0623 

BO 

FF 

503 

0625 

C3 



I N S T A T 

This routine is called to get the status of the receive 
character buffer. 


ENTRY CONDITIONS: 


OS : 
CH 


has segment address of bios data area 
has the device number 


EXIT CONDITIONS: 


AX destroyed. 

AL = O no character avialable, OR i nv 1 i d port # 
AL : FF character avialable 


XOR AL,AL ; assume inviaid port number 

CALL GETPCB ; got address of the port control block 

INSTX ; > exit if port number invalid 

LES BX, DWORD PTR PCRADR[BX] get address of the receive character 

MOV AX , ES : RBCOUNT ( BX ] ; get a characters available 

AND AX , AX ; If no Character available then 

JZ INSTX ; go exit (return code all set) 

MOV AL,OFFH ; else set proper return code 

INSTX: RET 


buffer 
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1 504 
1 505 
1 506 
1 507 
1 508 

1509 

1510 
15 11 
15 12 
15 13 
15 14 
15 15 
15 16 
15 17 
15 18 
15 19 
1520 
152 1 

1522 

1523 

1524 


BIOS EXTENTION SERVICE ROUTINES 


I N C H A R 

This is the lowest level of the routines available to draw a 
character out of the receive character buffer. This routine will return 
to the caller if no character is available. 


ENTRY CONDITIONS: 


EXIT CONDITIONS: 


device number 


If character available BP, 
CH = status of character 
CX * ascii character 


CX. AX is destroyed. 


If none available, or invalid port number. 


1525 








a11 registers except AX is preserved. I 

1526 




















1528 

0626 





INCHAR : 




1529 

0626 

E8 

09 1 1 

R 



CALL 

GETPCB 

get address pf pcb in to OS:BX 

1530 

0629 

73 

03 




JNC 

L 1 5 1 $ 

If invalid port number 

1 53 1 

062B 

32 

CO 




XOR 

AL , AL 

set error code 

1532 

0620 

C3 





RET 


r et ur n to ca 1 1 er 

1533 

062E 





L 1 5 1$ : 




1 534 

062E 

C4 

6F 33 



LES 

BP,0¥V0RD PTR PCRADRiBX] 

get receive character buffer to ES:BP 

1535 

063 1 

E8 

066A 

R 



CALL 

TXXON 

go do auto transmit xon/xoff chores 

1536 

0634 

9C 





PUSHF 


disable interrutps 

1 537 

0635 

FA 





CL I 



1538 

0636 

26 

8B 

46 

OO 


MOV 

AX , ES : RBCOUNT [ BP ] 

get # characters in the buffer 

1 539 

063A 

23 

CO 




AND 

AX , AX 

check to see if any characters 

1 540 

063C 

74 

20 




JZ 

I NCHAX 

> go exit if none 

154 1 

063E 

48 





DEC 

AX 

count down # characters in the buffer 

1542 

063F 

26 

89 

46 

OO 


MOV 

ES : RBCOUNT [ BP ] , AX 

update count 

1 543 

0643 

26 

8B 

76 

06 


MOV 

S ! , ES : RBOUT [ BP ] 

get pointer to next character drawn 

1 544 

0647 

26 

8B 

OC 



MOV 

CX , ES : O [ S I } 

get the next character 8 status 

1 545 

OS4A 

26 

3B 

76 

OE 


CMP 

SI , ES : RETAIL [ BP ] 

check to see if at end of buffer 

1546 

064E 

75 

06 




JNZ 

I NCHA 1 

If we are then, set pointer to the 

1 547 

0650 

26 

8B 

76 

OC 


MOV 

S I , ES : RBHEAO I BP ] 

beginning of the buffer 

1 546 

0654 

EB 

02 




JMP 

SHORT INCHA2 

(go put it into buffer table) 

1 549 

0656 

46 




I NCHA1 : 

INC 

S I 

Else, increment pointer by 2 

1 550 

0657 

46 





INC 

S I 

(point to next character) 

155 1 

0658 

26 

: 89 

76 

06 

I NCHA2 : 

MOV 

ES : RBOUT [ BP 1 , S I 

update pointer to the next character 

1552 

1553 

065C 

BO 

FF 




MOV 

AL , Of f h 

set return code : character available 

1 554 

065E 

90 




I NCHAX : 

POPF 


restore caller's flags 

1555 

065F 

C3 





RET 


: return to caller. 
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1556 

1557 

1558 

1559 

1560 

1561 

1562 

1563 

1564 

1565 

1566 
1 567 

1568 

1569 

1570 

1571 

1572 

1573 

1574 

1575 

1576 


0660 

0660 E8 0626 R 
0663 22 CO 

0665 74 F9 

0667 8B Cl 
0669 C3 


G E T C H A R 

This routine is called to read a character out of the receive buffer, and 
to wait till a character is available 

ENTRY CONOITIONS: Same as INCHAR 

EXIT CONDITIONS: Same as INCHAR, but character will always be available 

and the character will be in AX 


GETCHAR : 


CALL 

AND 

JZ 

MOV 

RET 


I NCHAR 
AL . AL 
GETCHAR 
AX , CX 


go to common routine to gat character 

check if sucessful 

repeat ti11 sucesful 

put character in correct register 

return to caller 
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1B77 









1576 


















1560 









1561 







TXXON 


1562 









1563 





; This 

rout i ne 

is called to see if its time to send an XON thru the port. 

1564 





; It wi 

11 exit 

immediately if xon. for any reason cannot be sent; and 

1565 





; a flag is set 

to send the auto xon as soon as possible. 

1566 





; 




1567 





; The criteria 

to send an XON are as follows: 1 

1566 









1569 







1 - an auto XOFF was previously sent by the driver | 

1590 







2 - receive character buffer reached a low mark 1 

1591 







3 - application did not s 

.end an XOFF 

1592 









1593 






ENTRY CONDITIONS: DS : BX F 

loints to port control block 

1594 







ES:BP F 

>oints to receive buffer area 

1595 









1596 









1597 






EXIT CONDITIONS: CX F 

>r eser ved 

1596 







OS:BX 

>r eser ved 

1599 







ES:BP 

>r eserved 

1 600 









1601 





; NOTE; 

If application sent an xoff, and 

auto xoff was also sent, then 

1602 






at the 

low water mark, auto xoff 

sent flag is cleared, but no 

1 603 






aut o xon i s sent ! ! ! 


1 604 


















1 606 

066A 




TXXON : 




1 607 

066A 

60 

7F 

30 

02 

CMP 

BYTE PTR PCTX0F(BXl,2 

check if transmit auto xon/xoff is 

1606 

066E 

75 

36 



JN2 

TXXONX 

enabled, exit if not 

1609 









16 10 

0670 

F6 

47 

1 4 

02 

TEST 

BYTE PTR PCFLAGfBX] . XMTXON ; If already flagged to send XON asap 

1611 

0674 

75 

IE 



JNZ 

TXX0N5 

> go check if it can be sent 

16 12 









1613 

0676 

F6 

47 

1 4 

04 

TEST 

BYTE PTR PCFLAGIBX] , XMTXOF ; Check if auto xoff was sent 

1614 

067A 

74 

2A 



JZ 

TXXONX 

> if not go return 

1615 

067C 

26 ; 

: 86 

46 

OO 

MOV 

AX, ES : RBCOUNT[BP] 

get P characters in the buffer 

1616 

0660 

26 : 

: 36 

46 

OA 

CMP 

AX . ES ; RBXON [ BP ] 

If buffer not at the right threshold 

1617 

0684 

75 

20 



JNZ 

TXXONX 

> go return to caller 

1616 

0666 

60 

67 

14 

FB 

AND 

BYTE PTR PCFLAG[BXl ,NOT 

(MTXOF clear auto xoff sent flag 

16 19 

068A 

F6 

47 

1 4 

60 

TEST 

BYTE PTR PCFLAGIBX] .APPXOF ; Check if application sent xoff 

1620 

068E 

75 

1 6 



JNZ 

TXXONX 

> if so return to caller 

1 621 

0690 

80 

4F 

14 

02 

OR 

BYTE PTR PCFLAG I BX 1 . XMTXON ; set flag to transmit xon asap 

1622 

0694 




TXX0N5 : 



now try to transmit the auto XON 

1 623 

0694 

F6 

47 

1 4 

08 

TEST 

BYTE PTR PCFLAGIBX] .XMTBRK ; Check to see if break being sent 

1624 

0698 

75 

OC 



JNZ 

TXXONX 

> if so don't send the auto xoh now 

1625 

069A 

6A 

67 

2D 


MOV 

AH. PCXONIBX ] 

try to send the xon 

1 626 

0690 

E6 

01F9 R 


CALL 

AUTOXMT 


1 627 

06A0 

74 

04 



JZ 

TXXONX 

>If not sucessful return to caller 

1 626 









1629 





: clear 

transmit xon asap and xoff was sent flag 
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1B31 06A2 SO 67 14 F9 AND BYTE PTR PCF L AG [ BX 1 . NOT (XMTXON * XMTXOF) 
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1 633 


1 634 




1636 


1 637 

0 0 T S T A T 

1 636 


1639 

This routine is called to get the status of the t ransmi t t er . 

1640 

The items checked are as follows: 

1 641 


1 642 

1 - Transmit buffer empty 

1 643 

2 - Not in an xoff'd mode 

1 644 


1 645 

This is the routine called when the application program wishes to 

1 646 

check the status. Note there are other items that may be useful 1 

1 647 

that can be added to this, namely: 

1 646 


1 649 

3 - break being transmitted. If this condition arises, it is 

1 660 

up to the appication program to keep track of this. 

1 65 1 


1 6S2 

4 - CTS not prresent (for limited modem control). Note that 

1 653 

in limited modem control, if CTS is not on, transmit 

1 654 

buffer will eventually get to a point where it won't 

1 655 

be ready. 

1656 


1 657 

The following are the motivation to leave them out of this routine: 

1 656 


1 659 

1 - most CP/M programs are written in such a way that they 

1 660 

tend to check the status often and not always needing 

166 1 

the remaining information. In those cases, efficiency 

1662 

of execution time is the most important factor. 

1663 


1664 

2 - The information on the other items can be obtained in 

1665 

other bios function calls. 

1 666 


1667 


1666 

ENTRY CONDITIONS. CH device number 

1669 

DS has BIOS segment address 

1 670 


1 671 

EXIT CONDITIONS: DX destroyed 

1 672 

AL = FF if character can be transmitted 

1 673 

that is transmit buffer empty. 

1 674 

not in an xoff'd mode. 

1 675 

Carry flag is cleared. 

1 676 


1 677 

AL E 0 OTHERWISE. AND 

1 676 

Carry flag set . 

1 679 

AH BITS set means XOFF received 

1 660 

AH BIT2 set means tranmit buffer not 

1 66 1 

empt y 

1 662 


1 663 

Note: the carry flag set/not set is to be used only between 

1 684 

BIOS routines for quick execution time, and is not to 

1 665 

be used by the appication program, since we cannot predict 
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what the operating syster 

n will do with this flag. 

1 689 

06A7 




OUTSTAT 




1690 

06A7 

E8 

09 11 R 


CALL 

GETPCB 

get address pf pcb in to OS:BX 

1 69 1 

06AA 

72 

1 5 



JC 

L 1 6 5$ 

> exit if port number invalid 

1692 

06AC 

6A 

67 

1 4 


MOV 

AH.PCFLAGIBX] 

check if XOFF was received 

1 693 

06AF 

80 

E4 

40 


AND 

AH , RCVXOF 


1 694 

06B2 

8B 

57 

12 


MOV 

OX , PCS7201 I BX ] 

get address of 7201 status/control register 

1 695 

06B5 

EC 




IN 

AL , OX 

read the status 

1 696 

06B6 

24 

04 



AND 

AL . BIT2 

gat the transmit buffer empty bit 

1 697 

06B8 

80 

cc 

04 


OR 

AH . BIT2 

Now set bit 2 in AH if transmit buffer 

1 698 

06BB 

32 

EO 



XOR 

AH . AL 

is not empty Note 7201 (value in AL ) 

1 699 








has bit 2 set if buffer IS empty • 

1 700 

06BD 

BO 

FF 



MOV 

AL . OFFH 

assume ok to transmit (AH zero) 

1701 

06BF 

74 

03 



J2 

L16 10$ 

If its so go exit 

1702 

06C 1 

32 

CO 


L 1 6__B$ : 

XOR 

AL . AL 

Else set flag to indicate otherwise. 

1703 

06C3 

F9 




STC 


sat carry flag to indicate cannot transmit 

1704 

06C4 

C3 



L 1 6_10$ 


RET 

ret urn to caller 
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1705 
1 706 
1 707 
1 708 

1709 

1710 
17 11 

1712 

1713 

1714 

1715 
17 16 

1717 

1718 

1719 
1 720 
1721 
1 722 
1 723 
1724 
1 725 
1726 
1 727 
1 728 
1 729 
1730 
1 731 
1 732 
1 733 
1734 
1 735 
1 736 
1 737 

1738 06CS 

1739 06C5 

1740 08C7 

1741 06C8 

1742 06C9 

1743 06CC 

1744 06CE 
1 745 

1746 0600 

1747 0603 

1748 0605 

1749 0609 

1750 06DB 

1751 O60E 
1 752 

1 753 
1 754 
1 755 

1756 06E0 

1757 06E4 


8A CA 

9C 

FA 

E8 06A7 R 
86 C8 
72 25 

3A 47 20 
75 06 

80 67 14 7F 

EB 00 
3A 47 2E 
75 08 


80 4F 14 80 
80 67 14 FO 


0 U T C H A R 

This routine is called to put a character into the transmit buffer. 
If for any reasons the character cannot be immediately placed on to 
the buffer, a return is made to the caller, with an indication that 
transmission was unsucessful. No attempt is made here to find out 
why the character cannot be transmitted (for fast execution time), i 
the 7201 has buffer empty, and the port is not xoff'd then the chara 
will be placed into the buffer. 


ENTRY CONOITIONS: 


CH 

OS 

OL 


device number 

has BIOS data area segment i 
character to be transmitted 


EXIT CONDITIONS; 


OL 


CL 

CL 


is destroyed in a11 cases. 

(this is ok, since in the next 
call, the value is reloaded fi 
the BIOS descriptor). 

O cannot send character 
FF character placed into the buff 


Note, that to implement auto xon/xoff properly, the transraited 
characters have to be examined to see if xoff or xon 
is sent by the application (or user). 

Further, it is faster and easier to always check for t 
instead of only when auto transmit xon/xoff is enabled 


OUTCHAR ; 

MOV CL,0L 

PUSHF 

CL I 

CALL OUTSTAT 

XCHG CL.AL 

JC OUTCHX 


save character to be transmitted 
make sure interrutps are off 

go see if we can transmit, also get PCB 
transfer return codes 
> exit if we can't transmit. 


CMP 

JNZ 

AND 

JMP 

L17_1$: CMP 

JNZ 


AL , PCXON ( BX ] 

L 1 7__1$ 

BYTE PTR PCFLAG 
SHORT L17__2$ 

AL . PCXOFF { BX 1 
L 1 7__2$ 


; check if xon charcter is sent 
; If it is, make sure “application 
[BX], NOT APPXOF ; flag is cleared, 
now go send character 
; check if xoff being sent 
; > If not go send the character 


sent 


xoff" 


else, set flag that application program sending xoff, 
to send auto xon as soon as possible. 


and clear flag 


OR 

AND 


BYTE 

BYTE 


PTR PCFLAG I BX 1 . APPXOF 
PTR PCFLAG ( BX 1 . NOT XMTXON 
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1 758 


1 759 

06E8 




L 17 2$ : 



now prepare data to be transmitted 

1760 

06E8 

8B 

57 

15 

MOV 

DX . PCMASK 

BXl 

mask the outgoing data 

1761 

06EB 

22 

C6 


AND 

AL . OH 



1762 

06ED 

OA 

C2 


OR 

AL , OL 



1763 

06EF 

8B 

57 

10 

MOV 

DX , PC7201 

BX] 

get data register address of 7201 

1 764 

06F2 

EE 



OUT 

DX , AL 


put out the character 

1765 

08F3 

B1 

FF 


MOV 

CL , OFFH 


set return code that character transmitted 

1766 









1767 

06F5 

90 



OUTCHX: POPF 



restore caller's flags 

1768 

06F6 

C3 



RET 



return to ca Tier 
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17B9 

1770 

1771 
1 772 









1 773 





P U 

T C H A R 


1774 









1 775 




This r out i ne 

is called to 

transmit a character, and to repeat 

unt i 1 

1 776 




the character 

is sucessfully accepted by the 7201 


1777 









1778 




ENTRY CONDITIONS: 

same as DUTCHAR 


1779 









1 780 




EXIT CONDITIONS: 

same as OUTCHAR 


1 78 1 






charcater will be taKen by 7201 


1782 






- - - - 



1783 

06F7 


PUTCHAR : 





1784 

OBF7 

52 


PUSH 

DX 


save character to be transmit 

t ed 

1785 

06F8 

E8 

06CS R 

CALL 

OUTCHAR 


call common routine to output 

char 

1786 

06FB 

5A 


POP 

DX 


restore character 


1 787 

06FC 

22 

C9 

AND 

CL , CL 


check if it was sucessful 


1 788 

06FE 

74 

F7 

JZ 

PUTCHAR 


repeat til sucessful 


1789 

0700 

C3 


RET 
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1793 









1794 






0 U T N 0 

W 

1795 









179 6 




; This 

rout i ne 

is called to transmit the character regardless of the 

1797 




; State 

of the 

modem signals or anything else. 

1798 









1799 




; Note 

that the absense of CTS. in limited modem control mode made 

1 800 




prevent the 

transmission of the 

character indefinitely. It is for 

1801 




; this 

r eason 

that the CTS signal 

is ignored for the transmission of 

1 802 




; this 

particular character. 



1803 









1 804 




; ENTRY 

CONDIT 

IONS: CH has device number 

1805 






DS points to BIOS data area 

1 806 






DL has character to be transmitted 

1807 









1808 




; EXIT 

CONDITIONS: command ignored if port number invalid 

1809 









1810 




; NOTE 

THAT THIS WILL NOT PROCESS 

auto XON/XOFF 

1811 


















18 13 









18 14 

0701 



OUTNOW: 





18 15 

0701 

E8 

09 11 R 

CALL 

GETPCB 


get address pf pcb in to DS : BX 

1816 

0704 

73 

01 


JNC 

L 1 8 1$ 


If port number invalid 

18 17 

0706 

C3 



RET 



> return to cal ler 

1818 

0707 



L 1 8 1$ ; 




Else cent i nue 

1819 

0707 

8A 

CA 


MOV 

CL . OL 


save character to be transmitted 

1820 

0709 

8B 

57 

1 2 

MOV 

DX , PCS7201 IBX ] 


get stat us/cont r o 1 rag address of 7201 

1821 

070C 

F6 

47 

OO 20 

TEST 

BYTE PTR PCCR3[BX: 

,BIT5 temporary disable "auto enable" if used 

1822 

0710 

74 

IE 


JZ 

0UTN2 


> If not used go wait for buffer empty 

1823 

07 12 

BO 

03 


MOV 

AL . CR3 


(Now d i sable i t ) 

1824 

07 1 4 

9C 



PUSHF 



make sure interrupts disabled 

1825 

0715 

FA 



CL I 




1826 

07 16 

EE 



OUT 

DX , AL 



1827 

0717 

8A 

47 

OO 

MOV 

AL , PCCR3 [ BX ] 


get value programmed into control reg 3 

1828 

071 A 

24 

DF 


AND 

AL .OFFH-BIT5 


take out auto enable bit 

1829 

071C 

EE 



OUT 

DX , AL 


do i t ! 

1830 

071D 

9D 



POPF 



restore interrupt state 

1831 

07 IE 

E8 

0730 R 

CALL 

DUTN2 


go wait for buffer empty and than send char 

1832 

072 1 

42 



INC 

DX 


point Dx back to status register 

1833 

0722 

42 



INC 

DX 



1834 

0723 

EC 


L18 5$: 

IN 

AL . DX 


wait for buffer empty 

1 835 

0724 

A8 

04 


TEST 

AL .BIT2 



1836 

0726 

75 

FB 


JNZ 

L18 5$ 



1837 

0728 

8A 

47 

OD 

MOV 

AL ,PCCR3IBX] 


get original value programmed into control reg 3 

1838 

072B 

B4 

03 


MOV 

AH . CR3 


set up to use common routine to do this 

1839 

072D 

E9 

0269 R 

JMP 

WRITE7201 


go to it, and bye bye! 

1840 









184 1 

0730 

9C 


0UTN2 : 

PUSHF 



make sure interrutps are off 

1842 

0731 

FA 



CLI 
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1 843 

0732 

EC 


IN 

AL , OX 

wait for buffer empty 


1844 

0733 

A8 

04 

TEST 

AL . BIT2 



184S 

0735 

75 

03 

JNZ 

L19_1$ 



1 846 

0737 

90 


POPF 


restore state of interrupt 

mask 

1847 

0738 

EB 

P6 

JMP 

SHORT 0UTN2 

loop, till buffer empty 


1848 

073A 



L 19 1$ : 




1849 

073A 

8A 

Cl 

~ MOV 

AL . CL 

restore character to be transmitted 

1850 

073C 

8B 

4F 1 5 

MOV 

CX , PCMASK[BXl 

get mask for character 


1 85 1 

073F 

22 

C5 

ANO 

AL . CH 



1852 

074 1 

OA 

Cl 

OR 

AL .CL 



1 853 

0743 

4A 


DEC 

OX 

point to data register 


1854 

0744 

4A 


DEC 

OX 



1855 

0745 

EE 


OUT 

OX . AL 

send i t ! 


1856 

0746 

90 


POPF 


restore caller's interrupt 

mask 

1857 

0747 

C3 


RET 


ret urn to caller 
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186 1 








1862 






R 0 M 0 C 

E M 

1663 








1864 




This rout i ne 

is called to read 

the modem signals. 

1865 








1866 





ENTRY 

CONDITIONS: CH device number 

1867 








1868 





EXIT CONDITIONS: 


1869 






AL bitO-bit6 has the modem signals 

1 870 








187 1 






AL bit7 « 1 if modem signals not available 

1872 








1873 






AH bit 0 e 1 transmitter empty 

1874 







: O transmitter not empty 

1875 
















! 1877 

0748 



RDMODEM 




1878 

0748 

33 

CO 


XOR 

AX , AX 

set error code 

1879 

074A 

E8 

09 

1 1 R 

CALL 

GETPCB 

get port control address 

1880 

0740 

72 

25 


JC 

L35 10S 

> exit if port is invalid 

1881 

074F 

8B 

57 

06 

MOV 

OX .PCMODMIBX] 

get address of the modem signal port 

1 882 

0752 

81 

FA 

FFFF 

CMP 

DX.OFFFFH 

see if modem signals can be read 

1883 

0756 

74 

07 


JZ 

L35 1$ 

If modem signals can be read then, 

1884 

0758 

EC 



IN 

AL , OX 

read the signals 

1885 

0759 

34 

FF 


XOR 

AL ,OFFH 

make it bit set means signal asserted 

1 886 

075B 

24 

IF 


AND 

AL , 1FH 

take out unwanted signals 

1867 

0750 

EB 

02 


JMP 

SHORT L35 2$ 


1888 

075F 

BO 

80 

L35 1$: 

MOV 

AL , 80H 

Else, mark modem signals not available 

1889 

076 1 

8A 

67 

14 L35 2$; 

MOV 

AH.PCFLAGCBX] 

read the state of the port flags 

1890 

0764 

80 

E4 

EO 

AND 

AH.OEOH 

take only high order 3 bits 

189 1 

0767 

50 



PUSH 

AX 

save the information 

1892 

0768 

8B 

57 

1 2 

MOV 

DX.PCS7201 IBX] 

get cont rol /status register for 7201 

1893 

076B 

EC 



IN 

AL , OX 

check if transmitter empty 

1894 

076C 

A8 

04 


TEST 

AL , BIT2 


1895 

076E 

58 



POP 

AX 

restore outgoing info 

1896 

076F 

74 

03 


JZ 

L35 10$ 

> if not empty exit 

1897 

077 1 

80 

cc 

01 

OR 

AH , BITO 

Else set flag that transmitter is empty 

1898 

0774 

C3 


L35_10$ : 


RET 

; return to caller. 
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1S99 

1900 

1901 

1902 

1903 

1904 

1905 
1909 
1907 
1 90S 
1909 
19 10 
19 11 
19 12 

1913 

1914 
1 9 IS 


1916 

1917 

0775 

0775 

8A 

C2 

1918 

0777 

E8 

09 11 R 

19 19 

077A 

72 

1 1 

1920 

077C 

8B 

57 06 

1921 

077F 

81 

FA FFFF 

1922 

0783 

74 

08 

1923 

0785 

24 

OF 

1924 

C787 

34 

FF 

1925 

0789 

EE 


1926 

078A 

BO 

FF 

1927 

078C 

C3 


1928 

1929 

0780 

32 

CO 

1930 

078F 

C3 
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SETMODEM 


This routlno is called to sot 
tho first 3 bits in tho mask 


the modem signals. Note that 
are set (to clear the dlagnost 


lc 


leds ) 


ENTRY CONDITONS: 


CH device number 

DL modem signal mask 


EXIT CONDITIONS: 


aL « PF If sucessful 
AL B O If port number invalid or, 
modem signal cannot be set 


SETMODEM: 

MOV 

CALL 

JC 

MOV 

CMP 

JZ 

AND 

XOR 

OUT 

MOV 

RET 


AL . OL 

GETPCB 

L20_lO$ 

DX . PCMODM(BX 1 
DX . OFFFFM 
L20 10$ 

AL . OFH 
AL . OFFH 
OX . AL 
AL . OFFH 


put the modem signals into correct reg 
get port control block 

> go exit If invalid port number 

get address of the port to set modem signals 
see If modem signals can be set 

> If not go exit with error condition set 
c 1 ear first 4 bits 

(zero bit value asserts the line) 
do It . 

set command processed return code 
r et ur n to caller 


L20 10$: 

~ RET 


XOR AL,AL 


return 


set error return code 
to caller 
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1931 

1932 

1933 

1934 

1935 

1936 

1937 

1938 

1939 

1940 

1941 

1942 

1943 


B R K 0 N 

This routine is called to Initiate the sending of break. 

ENTRY CONDITIONS: CH port number 

EXIT CONOTIONS: command Ignored If port number Invalid 


1944 

0790 




1945 

0790 

E8 

09 1 

1 1 R 

1946 

0793 

73 

oi 


1947 

0795 

C3 



1948 

0796 




1949 

0796 

8A 

4F 

14 

1950 

0799 

80 

C9 

08 

1951 

079C 

8A 

47 

OF 

1952 

079F 

OC 

10 


1953 

07A1 

EB 

1 1 



CALL 

JNC 

RET 


GETPCB 
L21 1$ 


get address of port control block 
If port number Invalid, 
return to caller 


1954 

1955 

1956 

1957 

1958 

1959 
19 80 

1961 

1962 

1963 

1964 

1965 

1966 


MOV 

CL , PCFLAG(BX ) 

; Else, 

: set flag 

t o 

OR 

CL , XMTBRK 



MOV 

AL , PCCR51BX] 

: set byte 

t o 1 

OR 

AL , BIT4 



JMP 

SHORT BRKCOMMON 

go and wr 

i t e 


B R K 0 

F F 



This routine is called to stop the sending of break. 


ENTRY CONDITIONS: 
EXIT CONOTIONS: 


CH port number 

Command Ignored If pert is invalid 


1967 

07A3 




BRKOFF : 



1968 

07A3 

E8 

09 

1 R 



CALL 

GETPCB get address of port control block 

1969 

07A6 

73 

OI 




JNC 

L22__1$ ; If Invalid port number 

1970 

1971 

07A8 

C3 





RET 

: > return to caller 

1972 

07A9 

8A 

4F 

1 4 

L22 1$: 

MOV 

CL , PCF L AG [ BX ] ; clear flag that show break being sent 

1973 

07AC 

80 

E 1 

F7 



AND 

CL, NOT XMTBRK 

1974 

07AF 

8A 

47 

OF 



MOV 

AL,PCCR5(BX] ; get old value in control register 5 

1975 

1976 

07B2 

24 

EF 




AND 

AL,NOT BIT4 ; clear send break bit In 7201 

1977 







Will 

have to consider sending the auto Xon. 

1978 







This 

Is messy, but necessary for proper handling! 

1979 







If buffer empty, and auto xoff was sent, we must send It 

1980 







now , 

since It may be the last time we get control. 

1981 

1982 

1983 







host 

Is Xoff'd, and missed Xon because of break being sent! 
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1tS4 

07B4 



BRKCOMMON : 




ISAS 

07B4 

44 

4F 14 

MOV 

PCFLAGIBX] .CL 

; rostora flag 


1 tSB 

07B7 

B4 

OS 

MOV 

AH. CR5 

: This is to be wr i 

tten to control rag 

1SS7 

07B9 

E9 

0249 R 

JMP 

WRITE7201 

: Go to, common subr 

out i no t o do it. 
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199 1 











1992 







R C 

V I 

N T 


1993 











1994 






This r out i ne 

is called to 

set 

up the receive character interrupt 1 

1995 






service routine. 




1996 











1997 






ENTRY 

CONDITIONS : 


CX , OX 

points to user information block 

1998 











1999 











2000 






EXIT CONDITIONS: 


AL s O 

invalid port number 

2001 









AL = FF 

function sucessfully performed. 

2002 






















2004 











2005 

07BC 




RCVl NT ; 





2006 

07BC 

8B 

E9 



MOV 

BP . CX 



; point ES.’BP to user's control block 

2007 

07BE 

8E 

C2 



MOV 

ES , OX 




2008 

07C0 

26 

8A 

6E OO 


MOV 

CH , ES : [ BP ] 



; get port number 

2009 

07C4 

32 

CO 



XOR 

AL . AL 



assume invalid port number 

2010 

07C6 

E8 

09 1 

1 R 


CALL 

GETPCB 



; get address of port control block 

201 1 

07C9 

72 

1 3 



JC 

L23 10$ 



; > exit if port number invalid 

201 2 











2013 

07CB 

26 

C4 

46 01 


LES 

AX, DWORD PT 

R ES 

IIBPI 

; get address of routine to be called 

2014 

07CF 

9C 




PUSHF 




; disable interrupts to do rest 

2015 

O7D0 

FA 




CL I 





2016 

07D1 

89 

47 

1 8 


MOV 

PCRCVAt BXI , 

AX 


; put it into the port control block 

2017 

07D4 

8C 

47 

1 A 


MOV 

PCRCVA-*^2 C BX 

] . ES 


; put segment address into PC bicok 

2018 

07D7 

C6 

47 

17 01 


MOV 

BYTE PTR PCRCVF 

BX) . 1 

set flag to indicate its on 

2019 

O70B 

90 




POPF 




restore user's flag state 

2020 

07DC 

BO 

FF 



MOV 

AL , OFFH 



; set sucessful return code 

2021 











2022 

07DE 

C3 



L23 10$: 

RET 



; return to cal ler 

2023 











2024 






















2026 











2027 







R C 

V C 

A N C E 

L 

2028 











2029 






This r out i ne 

i s ca lied to 

cancel the 

receive character interrupt 

2030 






service routine. 




203 1 











2032 






ENTRY 

CONDITIONS : 


CH 

port number 

2033 











2034 






EXIT CONDITIONS: 


command 

ignored if port number invalid 

2035 






















2037 

07DF 




RCVCANCEL : 





2038 

07DF 

E8 

09 1 

1 R 


CALL 

GETPCB 



; get address of port control block 

2039 

07E2 

72 

04 



JC 

L24 1$ 



; ignore command if invalid port # 

2040 

07E4 

C6 

47 

17 OO 


MOV 

BYTE PTR PCRCVF{BX].0 

; clear flag to call service routine 
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L24 1$: RET 


; return to callor 
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This routine is called to set up the transmit empty buffer interrupt 
service routine. 


ENTRY CONDITIONS: 


CX,DX points to the BIOS descriptor 


if port number invalid or not 
connect ed . 


AL : FF if command sucessfully implemented 


BP . CX 
ES . OX 

CH . ES : [ BP ] 

AL , AL 

GETPCB 

L25_1$ 

AX, DWORD PTR ES:1[BP] 


PCXMTAlBXl . AX 
PCXMTA<t'2lBX] , ES 
BYTE PTR PCXMTF[BX],1 


AL ,PCCR1 [BXl 
AL . CR1 TXBE 
PCCR 1 { BX 1 , AL 
AH , 1 

WRITE7201 
AL ,OFFH 


point ES:BP to user's control block 

get port number 

assume invalid port number 

get address of port control block 

> ignore command if invalid port 

get address of routine to be called 

disable interrupts to do rest 

put it into the port control block 
put segment address into PC bicok 
set flag to indicate its on 
restore user's flag state 
get image of control register 1 

save new value 
go write it to 7201 

set return sucessful code 
return to caller 


XMTCANCEL 


port number 


EXIT CONDITIONS: 


OBI 9 


XMTCANCEL : 
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20B5 

0819 

E8 

0911 R 

CALL 

GETPCB 

get address of port control block 

2096 

08 1C 

72 

1 1 

JC 

L26 1$ 

ignore command if port number invalid 

2097 

08 IE 

CB 

47 1C OO 

MOV 

BYTE PTR PCXMTFIBXI.O 

clear flag to call service routine 

2098 

0822 

BA 

47 OB 

MOV 

AL.PCCR1 IBX] 

get image of control register 1 

2099 

0825 

24 

FD 

AND 

AL.NOT CR1TXBE 


2100 

0827 

88 

47 OB 

MOV 

PCCR1 (BXl ,AL 

save new value 

2101 

082A 

B4 

01 

MOV 

AH. 1 

go write it to 7201 

2102 

082C 

E8 

02B9 R 

CALL 

WRITE7201 

2103 

082F 

C3 


L26 1$: RET 


return to cal ler 
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2104 

2105 

2106 
2107 
2 108 
2109 
21 10 
2 111 
2112 
2113 
2 114 

2115 

2116 

2117 

2118 

2119 

2120 
2121 
2122 

2123 

2124 

2125 

2126 

2127 

2128 
2129 
2 130 
2131 
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H A C K 7 2 O 1 

This routine is called to setup the interrupt vectors so that on 
the following interrupt from the appropriate 7201, the application 
service routine is called instead of the one in the BIOS. 


ENTRY CONDITION: 


EXIT CONDITIONS: 


DEVICE NUMBER ARE AS FOLLOWS: 


CX.DX point to a 5 byte descriptor 
where the first byte is the 
device number, and the next 4 
are the offset, and segment o 
the user service routine. 

NONE, no check is done at all. 


1 : comm port (PORT A) 

2 * printer port (PORT B) 

3 s optional comm (RS423) PORT B 

4 s optional comm (RS422) PORT A 


2132 

0830 



HACK7201 : 



2133 

0830 

8B 

E9 

MOV 

BP , CX 

; point ES:BP to descriptor area 

2134 

0832 

8E 

C2 

MOV 

ES , DX 


2135 

0834 

26 

8A 5E OO 

MOV 

BL , ES : (BP] 

; get device number 

2 1 36 

0838 

32 

FF 

XOR 

BH , BH 

: make it into offset to table 

2137 

083A 

4B 


DEC 

BX 


2138 

083B 

D 1 

E3 

SHL 

BX , 1 


2139 

0830 

26 

C4 6E 01 

LES 

BP, DWORD PTR ES : 

1(BP] ; point ES : BP to user service routine 

2140 

084 1 

9C 


PUSHF 


make sure interrupts are off 

2141 

0842 

06 


PUSH 

ES 

; save segment of service routine 

2142 

0843 

FA 


CL I 



2143 

0844 

8B 

87 0865 R 

MOV 

AX,HACKTAB[BX] 

; get address of the kludge to jump to user 

2144 

0848 

8B 

BF 0860 R 

MOV 

01 ,FIXTAB(BX] 

; now modify the offset of service routines 

2145 

084C 

B9 

0004 

MOV 

CX , 4 

: (4 offsets to be fixed) 

2146 

084F 

IE 


PUSH 

DS 

point ES to bios area 

2147 

0850 

07 


POP 

ES 


2148 

085 1 

FC 


CLO 


; (make sure of directions correct) 

2149 

0852 

AB 


L27 1$: STOS 

WORD PTRIOI] 


2150 

0853 

E2 

FD 

“ LOOP 

L27__1$ 

; repeat for 4 offset values 

2151 







2152 

0855 

07 


POP 

ES 

: restore segment of service routine 

2153 

0856 

0 1 

E3 

SHL 

BX , 1 

: calculate save area for vector (dev# -1)»4 

2154 

0858 

89 

AF 0000 E 

MOV 

HVECTOR(BX] , BP 

; save user service routines into the table 

2 1 55 

08SC 

83 

C3 02 

ADD 

BX, 2 


2156 

085F 

8C 

87 OOOO E 

MOV 

HVECTORlBX] , ES 
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2157 

0663 

80 



PCPF 


2158 

06B4 

C3 



RET 


2159 

2160 

06B5 



HACKTAB 

LABEL 

WORD 

2161 

06BS 

012A 

R 


DW 

HACKA 

2162 

0867 

012P 

R 


DW 

HACKB 

2163 

0669 

0134 

R 


DW 

HACKXB 

2164 

068B 

0139 

R 


DW 

HACKXA 

2165 

2166 

0680 



FIXTAB 

LABEL 

WORD 

2167 

0860 

OOF2 

R 


DW 

I NT7201 +8 

2168 

066F 

OOEA 

R 


DW 

INT7201 

2169 

067 1 

OOFA 

R 


DW 

INT7201+1 6 

2170 

0873 

0102 

R 


DW 

INT7201<»24 


roinstato Intorrupt status 
return to collar 
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2171 
2 1 72 
2173 
2 1 74 
2 1 75 
2176 
2 1 77 
2 1 78 
2 1 79 
2180 
2 18 1 
2182 

2183 

2184 

2185 

2186 

2187 

2188 

2189 

2190 
2 19 1 
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This routine is called to clean the vectors so that they will point 
to the default service routines. 


ENTRY CONDITION. 

EXIT CONOITIONS: 

DEVICE NUMBER ARE AS FOLLOWS; 


CH has device number 

NONE, no check is done at all. 


1 s comm port (PORT A) 

2 * printer port (PORT B) 

3 = optional comm (RS423) PORT B 

4 : optional comm (RS422) PORT A 


2192 







2193 

0875 


VECT7201 




2 194 

0875 

8A DO 


MOV 

BL , CH 

calculate the offset from device number 

2195 

0877 

32 FF 


XOR 

BH , BH 


2 196 

0879 

4B 


DEC 

BX 


2197 

087A 

01 E3 


SHL 

BX , 1 


2 198 

087C 

8B BF 0892 R 


MOV 

DI, VECTAB [BX] 

point to table to be fixed 

2199 

0880 

8B B7 069A R 


MOV 

SI, OURTAB (BX] 

point to default table 

2200 

0884 

B9 0004 


MOV 

CX . 4 

4 offsets to be fixed 

2201 

0887 

FC 


CLD 


make sure of direction for STDS, LODS 

2202 

0888 

IE 


PUSH 

DS 

point ES to BIOS area 

2203 

0889 

07 


POP 

ES 


2204 

088A 

9C 


PUSHF 


make sure were not interrupted 

2205 

0866 

FA 


CL I 



2206 

086C 

AO 

L28 1$: 

LODS 

WORD PTR [SI] 

repeat get default vector 

2207 

088D 

AB 


STDS 

WORD PTR [ DI ] 

put it into vector table 

2208 

068E 

E2 FC 


LOOP 

L28_1$ 

until all 4 vectors (per port) are fixed 

2209 

0890 

9D 


POPF 


reinstate interrupts status 

22 10 

089 1 

C3 


RET 


return to caller 

22 1 1 







22 1 2 

0892 


VECTAB 

LABEL 

WORD 


22 1 3 

0892 

OOF2 R 


DW 

I NT7201 +8 


22 14 

0894 

OOEA R 


DW 

INT7201 


22 1 5 

0896 

OOFA R 


DW 

I NT7201 + 1 6 


22 1 6 

0898 

0102 R 


DW 

I NT7201 +24 


22 17 







22 18 

089A 


OURTAB 

LABEL 

WORD 


22 19 

089A 

0112 R 


DW 

PORTA 


2220 

089C 

010A R 


DW 

PORTB 


2221 

089E 

01 1A R 


DW 

PORTXB 


2222 

08A0 

0122 R 


DW 

PORTXA 
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2223 

2224 
222B 
222t 
2227 
2224 

2229 

2230 

2231 

2232 

2233 

2234 

2235 

2236 

2237 
2236 
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S T A T C H 6 

This routine is collod to sot up the status change interrupt 
service routine. 


ENTRY CONDITIONS: 


EXIT CONDITIONS: 


CX.DX points to user information block 


AL 

AL 


O invalid port number 
FF function sucessfully performed. 


2239 

08A2 



STATCHC : 




2240 

08A2 

8B 

E9 

MOV 

BP , CX 


point ES : BP to user's control block 

224 1 

08A4 

8E 

C2 

MOV 

ES , OX 



2242 

08A6 

26 

8A BE OO 

MOV 

CH. ES : IBP] 


get port number 

2243 

08AA 

32 

CO 

XOR 

AL , AL 


assume invalid port number 

2244 

08AC 

E8 

09 11 R 

CALL 

GETPCB 


get address of port control block 

2245 
224 6 

08AF 

72 

1 3 

JC 

L29_10$ 


> exit if port number invalid 

2247 

08B1 

26 

C4 46 01 

LES 

AX. DWORD PTR ES 

1 [BP] 

get address of routine to be called 

2248 

08B5 

9C 


PUSHF 



disable interrupts to do rest 

2249 

08B6 

FA 


CL I 




2250 

08B7 

89 

47 22 

MOV 

PCSTCAIBX] . AX 


put it into the port control block 

2251 

08BA 

8C 

47 24 

MOV 

PCSTCA+2tBXl ,ES 


put segment address into PC bicok 

2252 

08BD 

C6 

47 21 01 

MOV 

BYTE PTR PCSTCFI 

[BX] . 1 

set flag to indicate its on 

2253 

08C 1 

90 


POPF 



restore user's flag state 

2254 

08C2 

BO 

FF 

MOV 

AL , OFFH 


set sucessful return code 

2255 








2256 

08C4 

C3 


L29_10$ : 

RET 


; return to caller 


2257 

2258 

2259 

2260 
226 1 
2262 

2263 

2264 

2265 

2266 

2267 

2268 

2269 

2270 
227 1 

2272 

2273 

2274 


STCANCEL 

This routine is called to cancel the status change interrupt 
ser V ice rout i ne . 


ENTRY CONDITIONS: 
EXIT CONDITIONS: 


CH port number 

command ignored if port number invalid 


08C5 

06C5 

08C8 

06CA 

OSCE 


E8 0911 R 
72 04 

C6 47 21 OO 


STCANCEL : 

CALL 


MOV 

L30_1$: RET 


GETPCB 

L30_1$ 

BYTE PTR PCSTCF[BX],0 


get address of port control block 
ignore command if invalid port # 
clear flag to call service routine 
r et ur n to caller 
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2275 

2276 

2277 

2278 

2279 

2280 
228 1 
2282 

2283 

2284 

2285 

2286 

2287 

2288 
2289 
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I N I T C 0 M 

This is the hard reset routine to reset all the variables and tables for 
all three ports (comm, printer and extended comm if it isinstalled) 


ENTRY CONDITIONS: 


EXIT CONDITIONS: 


OS 

OS ; XOPTION 


points to BIOS data area 
contains 2, if optional comm 
port present . 


2290 










229 1 

08CF 






INITCOM 



2292 

08CF 

BA 

0042 




MOV 

OX . AS7201 

2293 

0802 

E8 

0904 

R 



CALL 

RESET7201 

2294 










2295 

0805 

80 

3E 

OOOO E 

02 


CMP 

XOPTION . 2 

2296 

08DA 

C6 

06 

0003 E 

oi 


MOV 

PCXCOM+PCSTAT . 1 

2297 

08DF 

75 

OB 





JN2 

L3 1 1$ 

2298 

08E 1 

C6 

06 

0003 E 

OO 


MOV 

PCXCOM+PCSTAT , O 

2299 

08E6 

BA 

002A 




MOV 

OX , XAS7201 

2300 

08E9 

E8 

0904 

R 



CALL 

RESET7201 

2301 










2302 

08EC 






L31 1$: 



2303 

08EC 

B5 

03 





MOV 

CH . DEVMAX 

2304 

08EE 

E8 

09 1 1 

R 


L31 2$: 

CALL 

GETPCB 

2305 

08F 1 

72 

oc 





JC 

L31 3$ 

2306 

08F3 

C6 

47 

06 

1 1 5 



MOV 

BYTE PTR PCCRIIl 

2307 

08F7 

E8 

0577 

R 



CAL L 

DFLT7201 

2308 

08FA 

32 

02 





XOR 

DL , DL 

2309 

08FC 

E8 

0776 

R 



CALL 

SETMODEM 

2310 

08FF 

FE 

CD 




L31_3$ : 

DEC 

CH 

231 1 

0901 

75 

EB 





JNZ 

L31_2$ 

2312 










2313 







; Note 

that if 

AL is OFFh. some 

23 1 4 







; this 

i S set 

by PRG7201 

2315 










2316 

0903 

C3 






RET 


2317 










23 1 8 










2319 

0904 






RE5ET7201 : 


2320 

0904 

9C 






PUSHF 


2321 

0905 

FA 






CL I 


2322 

0906 

BO 

18 





MOV 

AL . RST7201 

2323 

0908 

EE 






OUT 

DX , AL 

2324 

0909 

BO 

02 





MOV 

AL . CR2 

2325 

090B 

EE 






OUT 

DX , AL 

2326 

090C 

BO 

10 





MOV 

AL . CR27201 

2327 

090E 

EE 






OUT 

DX . AL 


reset 7201 on mother board 


check if optional comm board present 
mark that optional board not present 
> if not skip optional board's 7201 
mark that optional board present 
reset 7201 on the optional board 


(now set default values to each port) 
start with highest device number 
get port control block address 
skip this port if device don't exist 
I set CR1 so to be programmed later 
to default values 

deassert modem signals, and for the 
xcomm port, set internal clocking 
repeat for all devices 


first disable interrupts 

reset 7201 
channel A 

point to control register 2A 

put 7201 in status affect vector mode 
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PACE 


BE- 1 


2353 

2354 

09 1 1 
09 1 1 

60 FD 03 

CETPCB : 

CMP 

CH . DEVMAX 

2355 

0914 

77 14 


JA 

L33 1$ 

2356 

09 1 6 

22 ED 


AND 

CH . CH 

2357 

0916 

74 10 


JZ 

L33 1$ 

2356 

09 1 A 

6A DO 


MOV 

BL . CH 

2359 

09 1 C 

32 FF 


XOR 

BH . BH 

2360 

09 1 E 

D 1 E3 


SHL 

BX , 1 

236 1 

0920 

6B 9F 092A R 


MOV 

BX . PCBTAB-2 (BX ] 

2362 

0924 

60 7F 03 OO 


CMP 

BYTE PTR PCSTAT(BX 

2363 

0926 

74 01 


JZ 

L33_2$ 

2364 

092A 

F9 

L33 1$: 

STC 


2365 

092B 

C3 

L33”2S : 

RET 


2366 

2367 
2366 

092C 


PCBTAB 

LABEL 

WORD 

2369 

092C 

OOOO E 


DW 

OFFSET PCCOM ; 

2370 

092E 

OOOO E 


DW 

OFFSET PCPRT ; 

2371 

0930 

OOOO E 


DW 

OFFSET PCXCOM ; 

2372 

2373 

2374 

0932 


CODE 

ENDS 

END 
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2332 

2333 

2334 
233B 

2336 

2337 
2336 
2336 

2340 

2341 

2342 

2343 

2344 
2346 

2346 

2347 
2346 

2349 

2350 

2351 
2362 


BIOS EXTENTION SERVICE ROUTINES 
ENOIP 


G E T P C B 

CETPCB is callod to got tho port control block for tho appropriate 
dav ico . 


ENTRY CONDITIONS: 
EXIT CONDITION: 


CH 

OS 


dovico number 

address of bios data area 


If port number valid A known to be connected then: 
BX * address of the port control block. 

OS « segment address of the bios data area 
All other registers are untouched 
CARRY FLAG CLEARED 

ELSE. Carry flag set. 


check if port number valid 
> if not go set error flag A return 


set up table pointer 


do table lookup. 

check if port present 

> go exit if present 

set return code not to touch port 

return to caller 


comm port control block 
printer port control block 
extended comm port control blockM 
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Macros : 


Name Length 

CALRET 0001 

SEO 0002 

TABLE 0002 


Segments and groups: 


N 


m e 


CGROUP 

CODE 


Symbo 1 s : 


N 


A7201 . . 

ABAUD. . 
AMODEM . 
APPXOF . 
ARXDAT . 
ARXSPC . 
AS7201 . 

ASeSUB . 
ASTAT. . 
ATXEMT . 
AUTOXMT . 
B7201 . . 

BAKGRND . 
BAUDMAX . 
BBAUD. . 
BITO . . 

BIT1 . . 

B1T2 . . 

B1T3 . . 

BIT4 . . 

BITS . . 

BIT6 . . 

BIT7 . . 

BMOOEM . 
BRKCOMMON 
BRKERR . 
BRKOFF . 
BRKON. . 
BRXDAT . 
BRXSPC . 
BS7201 . 

BSTAT. . 
BTXEMT . 
BUFFI . . 


S i 2 e 

align 

comb i 

GROUP 

0932 

BYTE 

PUBL 1 

Type 

Value 

Att r 

Number 

0040 


Number 

OOOE 


Number 

0002 


Alias 

BIT7 


L NEAR 

013E 

CODE 

L NEAR 

0246 

CODE 

Number 

0042 


Number 

001 A 


L NEAR 

0295 

CODE 

L NEAR 

0215 

CODE 

L NEAR 

01F9 

CODE 

Number 

004 1 


Number 

24AF 


Number 

O01 1 


Number 

0006 


Number 

O001 


Number 

0002 


Number 

0004 


Number 

0008 


Number 

O010 


Number 

0020 


Number 

0040 


Number 

0060 


Number 

OOFF 


L NEAR 

07B4 

CODE 

A 1 i as 

BIT7 


L NEAR 

07A3 

CODE 

L NEAR 

0790 

CDDE 

L NEAR 

0143 

CODE 

L NEAR 

023E 

CODE 

Number 

0043 


L NEAR 

026B 

CODE 

L NEAR 

021F 

CODE 

L NEAR 

052B 

CODE 


class 
' CODE ' 


Global 

Global 



02-20-84 
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BUFF10 . . . 

BUFFER . . . 

BUFFX. . . . 

CBDATB . . . 

CBLEN. . . . 

CBMOOE . . . 

CBPORT . . . 

CBPRTY . . . 

CBRAOR . . . 

CBRCVB . . . 

CBRXOF . . . 

CBSIZE . . . 

CBSTART. . . 

CBSTPB . . . 

CBTXB. . . . 

CBTXOF . . . 

CBXOFF . . . 

CBXON. . . . 

CLK16X . . . 

COMM STACK . 
CRl 

CR17201 . . . 

CR1TXBE. . . 

CR2 

CR27201 . . . 

CR3 

CR4 

CRS 

CR7201 . . . 

CTS 

DATABIT. . . 

DATABX . . . 

DATMAX . . . 

DC 1 

DCS 

DEVCOM . . . 

DEVMAX . . . 

DEVPRT . . . 

DEVXCOM. . . 

0FLT72O1 . . 

DFLTBUF. . . 

DFLTCOM. . . 

DFLTPRT. . . 

OFLTXCOM . . 

OSR 

DTR 

ENDTXBE. . . 

E0I72O1 . . . 

ERR7201 . , . 

FIXTAB . . . 

FRMERR . . . 

GETBAUD. . . 

CETCHAR. . . 


L NEAR 0531 
L NEAR 0514 
L NEAR 0576 
Numbor 0003 
Numbsr 001 1 
Number O001 
Number OOOO 
Number 0004 
Number OOOD 
Number 0005 
Number 0008 
Number OOOB 
L BYTE OOOO 
Number 0002 
Number 0006 
Number OOOA 
Number OOOB 
Number 0007 
Number 0040 
E NEAR OOEA 
Number OOOl 
Number 0015 
Number 0002 
Number 0002 
Number 0010 
Number 0003 
Number 0004 
Number 0005 
L NEAR OOB3 
Alias BITS 
L NEAR 03E7 
L NEAR 044F 
Number 0006 
Number 001 1 
Number 0013 
Number OOOl 
Number 0003 
Number 0002 
Number 0003 
L NEAR 0577 
L NEAR 05B8 

Y BYTE OOOO 

Y BYTE OOOO 

Y BYTE OOOO 
Alias BIT2 
Alias BIT2 
Number 0028 
Number 0038 
Number 0030 
L WORD 086D 
Alias BIT6 
L NEAR 04E1 
L NEAR 0660 


CODE 

CODE 

CODE 


CODE 


CODE 


CODE 

CODE 

CODE 


CODE 

CODE 

CODE 

CODE 

CODE 


CODE 

CODE 

CODE 
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GETPCB . 
HACK7201 
HACKA. . 
HACKB. . 
HACKTAB . 
HACKXA . 
HACKXB . 
HVECTOR . 
1NCHA1 . 
INCHA2 . 
INCHAR . 
INCHAX . 
INITCOM. 
INSTAT . 
INSTX. . 
INT7201 . 
INTEXIT . 
L 1 0 1 0$ . 
L1l“l$ . 
L 1 21^10$ . 
L13 1$ . 

L14”l$ . 

LIB^IS . 

L 1 e^ios . 
L 1 6“S$ . 

L17“l$ . 

L 17”2S . 
L18“"l$ . 
L 1 B^SB . 
L19“l$ . 

LI T$. . 

L20 10$. 
L2l“l$ . 
L22”'l$ . 

L23'"lCf . 
L24~1$ . 

L25”l$ . 

L2b”i$ . 
L27~1$ . 

L28~1$ . 
L29~10$ . 
L 2 1 0$ . 

L30_1$ . 

L31 1$ . 

L3l“2$ . 
L3l“3$ . 

L33~1$ . 
L33*“2$ . 
L34~l$ . 

L34 10$. 
L3B“i$ . 
L36“lO$ . 
L35~2$ . 


L 

NEAR 

09 1 1 

CODE 

L 

NEAR 

0630 

CODE 

L 

NEAR 

O 1 2A 

CODE 

L 

NEAR 

012F 

CODE 

L 

WORD 

0865 

CODE 

L 

NEAR 

0139 

CODE 

L 

NEAR 

0134 

CODE 

V 

WORD 

OOOO 

CODE 

L 

NEAR 

0656 

CODE 

L 

NEAR 

0658 

CODE 

L 

NEAR 

0626 

CODE 

L 

NEAR 

065E 

CODE 

L 

NEAR 

08CF 

CODE 

L 

NEAR 

0612 

CODE 

L 

NEAR 

0625 

CODE 

L 

WORD 

OOEA 

CODE 

L 

NEAR 

007 1 

CODE 

L 

NEAR 

05B8 

CODE 

L 

NEAR 

05BF 

CODE 

L 

NEAR 

05E9 

CODE 

L 

NEAR 

05FO 

CODE 

L 

NEAR 

0601 

CODE 

L 

NEAR 

062E 

CODE 

L 

NEAR 

06C4 

CODE 

L 

NEAR 

06C1 

CODE 

L 

NEAR 

06DB 

CODE 

L 

NEAR 

06E8 

CODE 

L 

NEAR 

0707 

CODE 

L 

NEAR 

0723 

CODE 

L 

NEAR 

073A 

CODE 

L 

NEAR 

0054 

CODE 

L 

NEAR 

078D 

CODE 

L 

NEAR 

0796 

CODE 

L 

NEAR 

07A9 

CODE 

L 

NEAR 

07DE 

CODE 

L 

NEAR 

07E8 

CODE 

L 

NEAR 

0818 

CODE 

L 

NEAR 

082F 

CODE 

L 

NEAR 

0852 

CODE 

L 

NEAR 

088C 

CODE 

L 

NEAR 

08C4 

CODE 

L 

NEAR 

021 1 

CODE 

L 

NEAR 

08CE 

CODE 

L 

NEAR 

08EC 

CODE 

L 

NEAR 

08EE 

CODE 

L 

NEAR 

08FF 

CODE 

L 

NEAR 

092A 

CODE 

L 

NEAR 

092B 

CODE 

L 

NEAR 

04F5 

CODE 

L 

NEAR 

04FA 

CODE 

L 

NEAR 

075F 

CODE 

L 

NEAR 

0774 

CODE 

L 

NEAR 

0761 

CODE 


G 1 oba 1 
Globa 1 
Ext er na 1 
Ext er na 1 
Ext er na 1 


C 1 oba 1 


Symbo 1 s - 3 


C 1 oba 1 


Ext er na 1 


G 1 oba 1 

C 1 oba 1 
Globa 1 
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Symbo 1 s* 4 


L3_10$ 

L4_1$. 

L4 10$ 

L5~l$. 

L5 13$ 

L$""l8$ 

L$“2$ . 

L5_3$. 

L8_1$ . 

L7_1$ . 

L7 10$ 

L8~10$ 

L8_5$ . 

L9_1$. 

L8_4$. 

MODE . 

MODE 1 . 

MODEMAX 

MODEX . 

NXTINT 

NXTINT1 

OURTAB 

OUTCHAR 

OUTCHX 

0UTN2 . 

OUTNOW 

OUTSTAT 

OVRERR 

PARERR 

PARITY 

PC7201 

PCBAUD 

PCBTAB 

PCCOM. 

PCCR1 . 

PCCR2 . 

PCCR3 . 

PCCR4 . 

PCCRS . 

PCDATB 

PCDFLT 

PCPAl L 

PCFLAC 

PCID . 

PCLEN . 

PCMASK 

PCMODE 

PCMODM 

PCPRT . 

PCPRTY 

PCRADR 

PCRATE 

PCRCVA 


L 

NEAR 

0205 

CODE 

L 

NEAR 

0330 

CODE 

L 

NEAR 

0341 

CODE 

L 

NEAR 

0361 

CODE 

L 

NEAR 

03A2 

CODE 

L 

NEAR 

03AD 

CODE 

1 

NEAR 

0383 

CODE 

L 

NEAR 

0390 

CODE 

L 

NEAR 

03CB 

CODE 

L 

NEAR 

0428 

CODE 

L 

NEAR 

03FC 

CODE 

L 

NEAR 

04A0 

CODE 

L 

NEAR 

0493 

CODE 

L 

NEAR 

04C9 

CODE 

L 

NEAR 

0409 

CODE 

L 

NEAR 

03B6 

CODE 

L 

NEAR 

0306 

CODE 

Number 

0002 


L 

NEAR 

03E6 

CODE 

L 

NEAR 

002A 

CODE 

L 

NEAR 

0065 

CODE 

L 

WORD 

089A 

CODE 

L 

NEAR 

06C5 

CODE 

L 

NEAR 

06F5 

CODE 

L 

NEAR 

0730 

CODE 

L 

NEAR 

0701 

CODE 

L 

NEAR 

06A7 

CODE 

Alias 

BITS 


Alias 

BIT4 


L 

NEAR 

0342 

CODE 

Number 

00 10 


Number 

0008 


L 

WORD 

092C 

CODE 

V 

BYTE 

OOOO 

CODE 

Number 

OOOB 


Number 

OOOC 



Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
V BYTE 
Number 
Number 
Number 
Number 


0000 
OOOE 
OOOF 
0029 
0004 
0026 
00 1 4 
OOOO 
0037 
00 15 
0027 
0006 
OOOO 
002A 
0033 
OOOA 
00 18 
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PCRCVB 

Number 

002B 


PCRCVF 

Number 

00 1 7 


PCRXOF 

Number 

002F 


PCS7201 

Number 

00 12 


PCSIZE 

Number 

0031 


PCSTART 

L BYTE 

OOOO 

CODE 

PCSTAT 

Number 

0003 


PCSTCA 

Number 

0022 


PCSTCF 

Number 

002 1 


PCSTPB 

Number 

0028 


PCTXB 

Number 

002C 


PCTXOF 

Number 

0030 


PCXCOM 

V BYTE 

OOOO 

CODE 

PCXMTA 

Number 

001D 


PCXMTF 

Number 

00 1C 


PCXOFF 

Number 

002E 


PCXON 

Number 

0020 


PORTA 

L WORD 

0112 

CODE 

PORTB 

L WORD 

010A 

CODE 

PORTXA 

L WORD 

0122 

CODE 

PORTXB 

L WORD 

01 1 A 

CODE 

PRG7201 

L NEAR 

0206 

CODE 

PRGCM2 

L NEAR 

0305 

CODE 

PRGCM3 

1 NEAR 

0310 

CODE 

PRGERR 

L NEAR 

0318 

CODE 

PRTYMAX 

Number 

0003 


PUTCMAR 

L NEAR 

06F7 

CODE 

RBCOUNT 

Number 

OOOO 


RBDFLT 

Number 

0020 


RBHEAD 

Number 

OOOC 


RBIN 

Number 

0004 


RBLEN 

Number 

0010 


RBMAX 

Number 

0002 


ABOUT 

Number 

0006 


RBSTART 

L BYTE 

OOOO 

CODE 

RBTAIL 

Number 

OOOE 


RBXOPF 

Number 

0008 


RBXON 

Number 

OOOA 


RCVB1 

L NEAR 

0467 

CODE 

RCVB2 

L NEAR 

047B 

CODE 

RCVBAUD 

L NEAR 

0450 

CODE 

RCVBPRT 

L NEAR 

0483 

CODE 

RCVBRK 

Alias 

BITO 


RCVBX 

L NEAR 

0482 

CODE 

RCVCANCEL 

L NEAR 

07DF 

CODE 

RCVCOMMON 

L NEAR 

060A 

CODE 

RCVDIS 

L NEAR 

05FB 

CODE 

RCVENA 

L NEAR 

05EA 

CODE 

RCVINT 

L NEAR 

07BC 

CODE 

RCVOFF 

Alias 

BITS 


RCVX 

L NEAR 

01 F8 

CODE 

RCVXOF 

Alias 

BIT6 



L NEAR 

0748 

CODE 


C 1 obe 1 

Globa 1 
Global 

Ext er na 1 


Ext er na 1 


Symbo 1 s- 5 


Ext er na 1 

Global 
G loba 1 


C loba 1 

G 1 oba 1 
C 1 oba 1 
G 1 oba 1 

G 1 oba 1 
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COMB lOS 






RDNVMCOM 

L 

NEAR 

OOOO 

CODE 

Ext er na 1 

RDSETUP 

L 

NEAR 

05CA 

CODE 

Global 

REC1 

L 

NEAR 

0 167 

CODE 


REC3 

L 

NEAR 

0 172 

CODE 


REC4 

L 

NEAR 

0198 

CODE 


REC5 

L 

NEAR 

01 9A 

CODE 


RECB 

L 

NEAR 

0 1 AO 

CODE 


REC7 

L 

NEAR 

01 B5 

CODE 


REC8 

L 

NEAR 

01 B7 

CODE 


RECB 

L 

NEAR 

01 D7 

CODE 


RECEIVER 

L 

NEAR 

01 4B 

CODE 


RECX 

L 

NEAR 

0 1 E3 

CODE 


RESET7201 

L 

NEAR 

0904 

CODE 


RI 

A 1 

ias 

B I TO 



RLSD 

A 1 

ias 

B I T4 



RST7201 

Number 

00 1 8 



RTS 

A1 

ias 

B I T3 



RUPT7201 

L 

NEAR 

OOOO 

CODE 

G 1 oba 1 

RUPTCOMMON 

L 

NEAR 

00 1 2 

CODE 


SAVE SP 

L 

WORD 

00A6 

CODE 


SAVE SS 

L 

WORD 

OOA8 

CODE 


SETMODEM 

L 

NEAR 

077S 

CODE 

Global 

SPDI 

A1 

ias 

BI T 1 



SPREC 

L 

NEAR 

0253 

CODE 


SPREC1 

L 

NEAR 

0262 

CODE 


SPRECEI VE 

L 

NEAR 

024B 

CODE 


SPRECX 

L 

NEAR 

0268 

CODE 


SPSEL 

A1 

ias 

B I TO 



SRI 

Number 

OOO 1 



SR2 

Number 

0002 



SR3 

N umber 

0003 



SRLSD 

A1 

ias 

B I T 1 



SRTS 

A1 

ias 

B I T 1 



STATCHG 

L 

NEAR 

08A2 

CODE 

Globa 1 

STCANCEL 

L 

NEAR 

08C5 

CODE 

Global 

STOPBIT 

L 

NEAR 

03 1 B 

CODE 


STPBMAX 

Number 

0003 



SX7201 

Number 

OO 1 0 



TXBUFFER 

L 

NEAR 

0222 

CODE 


TXBUFX 

L 

NEAR 

0237 

CODE 


TXXON 

L 

NEAR 

066A 

CODE 


TXXONS 

L 

NEAR 

0694 

CODE 


TXXONX 

L 

NEAR 

06A6 

CODE 


VECT7201 

L 

NEAR 

0875 

CODE 

G 1 oba 1 

VECTAB 

L 

WORD 

0892 

CODE 


WRITE7201 

L 

NEAR 

0269 

CODE 


XA7201 

Number 

0028 



XABAUD 

Number 

002 1 



XAEXIT 

L 

NEAR 

027C 

CODE 


XAMODEM 

Number 

OOFF 



XARXDAT 

L 

NEAR 

0286 

CODE 


XARXSPC 

L 

NEAR 

028 1 

CODE 


XAS7201 

Number 

002A 




The Microsoft MACRO Assembler 02-20'S4 PACE Symbo1s-7 

COMB I OS 


XASTAT L NEAR 027A CODE 

XATXEMT L NEAR 0276 CODE 

XB7201 Number 0029 

XBAUD1 V BYTE OOOO CODE External 

XBAUD2 V BYTE OOOO CODE External 

XBMODEM Number 0002 

XBRXDAT L NEAR 0146 CODE 

XBRXSPC L NEAR 0243 CODE 

XBS7201 Number 002B 

XBSTAT L NEAR 0290 CODE 

XBTXEMT L NEAR 021A CODE 

XINT7201 L WORD OOFA CODE 

XMTBO L NEAR 04B8 CODE 

XMTBAUD L NEAR 04A1 CODE 

XMTBRK Alias BIT3 

XMTBX L NEAR 04E0 CODE 

XMTCANCEL L NEAR 08 19 CODE Global 

XMTMTV L NEAR 07E9 CODE Global 

XMTXOF Alias BIT2 

XMTXON Alias BIT1 

X0N0F1 L NEAR 0508 CODE 

XONOFF L NEAR 04FD CODE 

XONOFX L NEAR 0513 CODE 

XOPTION V BYTE OOOO CODE External 

XRUPT7201 L NEAR OOOA CODE Global 

XSTAT1 L NEAR 02BC CODE 

XSTATCHG L NEAR 0298 CODE 

XSTATX L NEAR 02C0 CODE 

?N Number O0 1 0 


Warning Severe 
Errors Errors 
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Symbol Cross Reforonco 
?H 


A7201 . . 

ABAUD . . 

AMODEM . 
APPXOP . 
ARXOAT . 
ARXSPC . 
AS7201 . 

ASCSUB . 
ASTAT . . 

ATXEMT . 
AUTOXMT . 

B7201 . . 

BAKGRND . 
BAUDMAX . 
BBAUD. . 
BITO . . 

BIT1 . . 

BIT2 . . 

BITS . . 

B1T4 . . 

BITS . . 

BITS . . 

BIT7 . . 

BMODEM . 
BRKCOMMON 
BRKERR . 
BRKOFF . 
BRKON. . 
BRXDAT . 
BRXSPC . 
BS7201 . 

BSTAT. . 
BTXEMT . 
BUFFI . . 

BUFFIO . 
BUFFER . 
BUFFX. . 

CALRET . 
CBDATB . 
CBLEN. . 
CBMODE . 
CBPORT . 
CBPRTY . 


(# is definition) Cref-1 


78# 

78 

78# 

78 

78# 

78 

78# 

78# 

78 

78# 

78 

78# 

78 

78# 

78# 

78 

78 

78# 

78 

78# 

78 

78 

78# 

78 

78# 

78 

78# 

78 

78 

78# 

78 

78# 

78 

78# 

78 

78 

78# 

78 

78# 

78 

78# 

78 

78 

78# 

78 

78# 

78 

78# 

78 

78 

78# 

78 

78# 

78# 

78 

78# 

78# 

78 

78# 

78 

78# 

78 

78# 


78 

78# 

78 

78# 

78 

78# 

78 

78 

78# 

78 

78# 

78 

78# 

78 

78# 

78 

78# 

78 

78# 

78 

78# 

78# 

78 

78# 

78 

78# 

78 

78# 

78# 

78 

78# 

78 

78# 

78 

78# 

78# 

78 

78# 

78 

78# 

78 

78# 

78# 

78 

78# 

78 

78# 

78 

78# 

78 

78# 

78 

78# 

78 

78# 

78 

78 

78# 

78 






78# 

78# 

78# 


78# 

1283 

16 19 

1 748 

1756 

299 

330 

375# 



300 

331 

6 15# 



78# 

205 

2292 



78# 

456 




298 

329 

728# 



297 

328 

550# 



484 

520# 

1 626 



78# 





78# 





78# 

1 193 




78# 





78# 

78 

78 

78 

936 

78# 

78 

78 

78 

78 

78# 

78 

78 

78 

525 

78# 

78 

78 

87 1 


78# 

78 

78 

1952 

1975 

78# 

78 

78 

978 

1037 

78# 

78 

78 

1 037 

1045 

78# 

78 

736 

1 045 


78# 





1953 

1984# 




78# 

750 




1 17 

1967# 




1 1 6 

1944# 




295 

324 

382# 



296 

325 

607# 



78# 

1 67 

203 



294 

323 

720# 



293 

322 

577# 



1262 

1266# 




1272# 

1 388 




834 

1257# 




1260 

1265 

13 10# 



26 1 





78# 

895 

9 1 1 

1 OOO 

1 005 

78# 

1418 




78# 

962 

9 67 



78# 





78# 

898 

900 

902 

906 


1447 1470 1897 

621 936 

871 1696 1697 1 83S 1844 1894 


1821 1828 


91S 922 


COHBIOS 


Symbol Cross Reference 


(# is 

def i n i t i o 

n ) 

Cref 

-2 

CBRADR 

. . 78# 

1268 





CBRCVB 

. . 78# 

1072 

1079 

1084 

1 100 

1 109 

CBRXOF 

. . 78# 

826 





CBSI2E 

. . 78# 

1 258 

1264 




CBSTART 

. . 78# 






CBSTPB 

. . 78# 

858 

863 




CBTXB 

. . 78# 

1101 

1 103 

1 106 

1 1 37 

1 1 44 

CBTXOF 

. . 78# 

830 





CBXOFF 

. . 78# 

1 237 





CBXON 

. . 78# 

1 233 





CGROUP 

. . 73 

75 

75 

75 

75 


CLK16X 

. . 78# 

1 339 





CODE 

. . 73 

74# 

74 

2373 



COMM STACK 

. . 186 

273# 





CR1 

. . 78# 

1 358 





CR1 7201 

. . 78# 

2306 





CR1 TXBE 

. . 78# 

2074 

2099 




CR2 

. . 78# 

2324 





CR27201 

. . 78# 

2326 





CR3 

. . 78# 

981 

1048 

1 475 

1 823 

1838 

CR4 

. . 78# 

942 





CR5 

. . 78# 

1040 

1349 

1986 



CR7201 

. . 209 

212 

220 

248# 




1 147 


DATABIT 822 999# 

OATABX 1002 10S1# 

DATMAX 78# 1003 

0C1 78# 

0C3 78# 

DEVCOM 78# 

DEVMAX 78# 2303 2354 

DEVPRT 78# 1082 1 149 1 198 

DEVXCOM 78# 

0FLT72O1 102 1327# 2307 

DFLTBUF 103 1330 1379# 

DFLTCOM 84# 

OFLTPRT 88# 

DFLTXCOM 8S# 

OSR 78# 

OTR 78# 


ENDTXBE 78# 

E0I72O1 78# 

ERR7201 78# 

FIXTAB 2144 

FRMERR 78# 

GETBAUD 1075 

GETCHAR 109 

GETPCB 81S 

2010 


589 690 

231 

633 702 

2166# 

635 749 

1140 1190# 

1671# 1574 

1328 1380 1413 1442 1465 1496 

2038 2064 2095 2244 2271 2304 


1529 1690 

2353# 


1815 1879 


1918 1945 1968 


HACK7201 


123 


2132# 



COMBIOS 


Symbol Cross Roforonce 


(# is dofinition) Crof-3 


HACKA 346# 2161 

HACKS 350# 2162 

HACKTAB 2143 2160# 

HACKXA 356# 2164 

MACKKB 354# 2163 

HVECTOR 94# 347 351 3SS 366 2164 2166 

INCHA1 1646 1646# 

INCHA2 1546 1651# 

IHCMAR 108 1626# 1572 

INCHAX 1640 1664# 

INITCOM 98 2291# 

INSTAT 107 1494# 

IHSTX 1497 1601 1603# 

1NT7201 166 292# 2167 2168 2166 2170 2213 2214 2216 2218 

INTBXIT 213 221 234# 

L10_10$ 1329 1361# 

L11_1$ 1381 1364# 

L12_10$ 1414 1426# 

L13__1$ 1443 1446# 

L14_1$ I486 1466# 

L16__1$ 1630 1533# 

L16_10$ 1701 1704# 

L16_5$ 169 1 1702# 

L17_1$ 1747 1760# 

L17_2$ 1749 1761 1759# 

L16_1$ 1616 1618# 

L16_6$ 1834# 1836 

L19_1$ 1845 1848# 

LI^IS 204 215# 

L20_10S 1919 1922 1929# 

L21_1$ 1946 1948# 

L22_1$ 1969 1972# 

L23_10$ 2011 2022# 

L24_1$ 2039 2041# 

L26__1$ 2065 2079# 

L26_1$ 2096 2103# 

L27_1$ 2149# 2160 

L28_1$ 2206# 2208 

L29_10$ 2245 2256# 

L2_10$ 626 637# 

L30_1$ 2272 2274# 

L31_1$ 2297 2302# 

L31_2$ 2304# 2311 

L31_3$ 2305 2310# 

L33_1$ 2355 2357 2364# 

L33_2$ 2383 2366# 

L34_l$ 1 199 1201# 

L34_10$ 1 192 1 194 1207# 

U35_1$ 1883 1888# 

L35_10$ I860 1896 1698# 

L36_2$ 1887 1889# 

L3_10$ 765 769 771# 

L4_1$ 862 666# 


COMBIOS 


Symbol Cross Reforonco 


(# is dofinition) Crof-4 


L4_10$ 
L5 1$ . 
LS“’l3$ 
L5”l5$ 
L5 2$. 
LB^SS . 
L6”lS . 
L7*“l$ . 
L7__10$ 
L8_10$ 
L8 5$ . 
L9"l$ . 
L9_4$ . 

MOOE . 
M0DE1 . 
MODEMAX 
MOOEX . 

NXTINT 

HXTINT1 

0URTA6 

OUTCHAR 

OUTCHX 

0UTN2 . 

OUTNOW 

OUTSTAT 

OVRERR 


PARITY 
PC7201 
PCBAUD 
PCBTAB 
PCCOM. 
PCCR1 . 
PCCR2 . 
PCCR3 . 
PCCR4 . 
PCCRS . 
PCDATB 
PCOFLT 
PCFAIL 
PCFLAC 


^PCIO . 
PCLEN. 
PCMASK 
PCMODE 
PCMODM 
PCPRT . 
PCPRTY 
PCRADR 


860 

878# 





896 

905# 

9 1 4 




929 

932 

934# 




908 

939# 





899 

901 

904 

9 10 

912 

919# 

921 

926# 





966 

970# 





1013 

1017 

102 1 

1025 

1031 

1033# 

1004 

1008# 





1 107 

1112# 





1 102 

1 106# 





1 160 

1 163# 





1 162 

1 1 62# 





821 

96 1# 





974 

976# 





78# 

966 





964 

964# 





193# 






201 

223# 





2199 

22 1 8# 





1 1 1 

1738# 

1786 




1744 

17 67# 





1 822 

1831 

1841# 

1847 



1 13 

1814# 





1 10 

1 689# 

1742 




78# 

636 

749 




78# 

636 

746 




820 

894# 





78# 

414 

1763 




78# 

109 1 

1 1 63 




2361 

2366# 





80# 

207 

376 

651 

616 

729 

78# 

253 

1367 

2073 

2076 

2098 

78# 






78# 

269 

977 

660 

1044 

1047 

78# 

260 

870 

673 

936 

638 

78# 

256 

1036 

1039 

1346 

1348 

78# 

613 

1009 




78# 

1338 





78# 

208 

21 1 

219 



78# 

423 

427 

479 

486 

741 

1618 

1619 

1621 

1623 

1 631 

1 662 

78# 






78# 

1366 





78# 

434 

526 

629 

1036 

1760 

78# 

971 

1415 




78# 

1661 

1920 




82# 

210 

383 

678 

608 

721 

78# 

926 





78# 

437 

1285 

1266 

1466 

1634 


2369 

2100 2306 


1446 

941 

1951 

1466 

1339 

1974 

1474 

1821 

1827 

1837 

743 

766 

1263 

1344 

1448 

1471 

1748 

1766 

1767 

1866 

1946 

1672 


1650 

2370 


1610 1613 

1666 



COMBIOS 


Symbol Cross Roference 


(# is dofinition) Cref-S 


PCRATE . 
PCRCVA . 
PCRCVB . 
PCRCVF . 
PCRXOF . 
PCS7201 . 
PCSIZE . 
PCSTART . 
PCSTAT . 
PCSTCA . 
PCSTCF . 
PCSTPB . 
PCTXB. . 
PCTXOF . 
PCXCOM . 
PCXMTA . 
PCXMTF . 
PCXOFF . 
PCXON. . 
PORTA. . 
PORTB. . 
PORTXA . 
PORTXB . 
PRG7201 . 
PRGCM2 . 
PRGCM3 . 
PRGERR . 
PRTYMAX . 
PUTCHAR . 

RBCOUNT . 
RBDFLT . 
RBHEAD . 
RBIN . . 

RBLEN. . 
RBMAX. . 
RBOUT. . 
RBSTART . 
RBTAIL . 
RBXOFF . 
RBXON. . 
RCVB1 . . 

RCVB2. . 
RCVBAUD . 
RCVBPRT . 
RCVBRK . 
RCVBX. . 
RCVCANCEL 
RCVCOHMON 
RCVDIS . 
RCVENA . 
RCVINT . 
RCVOFF . 
RCVX . . 

RCVXOF . 


78# 

1086 

1090 

1 154 

1 1 62 


78# 

492 

2016 

2017 



78# 

1085 

1151 




78# 

489 

49 1 

493 

495 

2018 

78# 

417 

829 




78# 

249 

521 

588 

619 

626 

78# 

1284 





78# 






78# 

2296 

2298 

2362 



78# 

767 

2250 

225 1 



78# 

764 

766 

768 

770 

2252 

78# 

867 





78# 

1 1 48 





78# 

472 

833 

1 607 



8 1# 

218 

390 

564 

6 1 2 

725 

78# 

584 

2069 

2070 



78# 

58 1 

583 

585 

587 

207 1 

78# 

425 

483 

1240 

1750 


78# 

42 1 

1 236 

1 625 

1746 


327# 

22 1 9 





32 1# 

2220 





339# 

2222 





333# 

222 1 





101 

8 11# 

1341 




828 

830# 





832 

834# 





816 

839# 





78# 

920 





1 1 2 

1783# 

1 788 




78# 

440 

460 

474 

1302 

1499 

78# 

126 1 

1 387 




78# 

448 

465 

1293 

1547 


78# 

442 

47 1 

129 1 



78# 

126 1 

1 287 

1290 

1387 


78# 

44 1 

475 

1 300 



78# 

1292 

1543 

155 1 



78# 






78# 

450 

463 

1297 

1545 


78# 

477 

1 304 




78# 

1 307 

16 16 




1077 

1081# 





1 089# 






823 

1071# 





1083 

1099# 





78# 

74 1 

743 

756 



1 074 

1093# 





1 1 9 

1333 

2037# 




1 449 

1 473# 





106 

1464# 





105 

1 35 1 

1441# 




1 1 8 

2005# 





78# 

1 448 

1 47 1 




490 

494 

496# 




78# 

423 

427 

1 283 

1693 



2040 

672 731 1354 1684 1620 1892 

2273 

2296 2298 2371 

2097 

1538 1542 1615 


COMBIOS 


Symbol Cross Reference 


(# is definition) Cref-6 


RDMODEM. . 
RDNVMCOM . 
ROSETUP. . 
REC1 . . . 
REC3 . . . 
REC4 . . . 
REC5 . . . 
REC6 . . . 
REC7 . . . 
REC8 . . . 
REC9 . . . 
RECEIVER . 
RECX . . . 
RESET7201 . 
RI . . . . 
RLSD . . . 
RST7201 . . 
RTS. . . . 
RUPT7201 . 
RUPTCOMMON 


114 1877# 

92# 1335 

104 1408# 

422 425# 

418 426 

449 452# 

451 455# 

443 458# 

464 467# 

466 470# 

476 481# 

377 384 

424 428 

206 217 

78# 

78# 

76# 2322 

78# 

96 163# 

168 178# 


433# 


413# 

457 

2293 


644 


473 

2300 


478 

2319# 


480 


485 


487# 


SAVE_SP 183 241 266# 

SAVE_SS 184 240 267# 

SEO 78 78 78 78 

78 78 78 78 

78 78 78 78 

78 78 78 78 

78 78 

SETMOOEM 115 19 16# 2309 

SPDI 76# 

SPREC 609 613 625# 

SPREC1 637# 752 

SPRECEIVE 618# 

SPRECX 622 646# 

SPSEL 78# 

SRI 78# 628 744 

SR2 78# 

SR3 78# 

SRLSD 78# 

SRTS 78# 

STATCHG 126 2239# 

STCANCEL 127 2270# 

STOPBIT 819 857# 

STPBMAX 78# 861 

SX7201 78# 694 734 1353 

TABLE 78 78 78 

TXBUFFER 552 565 579# 

TXBUFX 582 586 588# 

TXXOM 1535 1806# 

TXX0N5 161 1 1622# 

TXXONX 1608 1614 1617 1620 

VECT7201 124 2163# 


78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 


1624 1627 1632 # 


78 

78 

78 

78 



COHBIOS 


Symbol Cross Roforonce 


( # is def i n i t i on ) 


VECTAB 


219B 2212# 


WRITE7201 


252 255 265 

2077 2102 


262 


665# 943 


952 


104 1 


1049 1360 1359 


1476 1536 


1957 


XA7201 . 

XABAUD . 
XAEXIT . 
XAMODEM. 
XARXDAT . 
XARXSPC . 
XAS7201 . 
XASTAT . 
XATXEMT . 
XB7201 . 

XBAUD1 . 
XBAUD2 . 
XBMODEM. 
XBRXDAT . 
XBRXSPC . 
XBS7201 . 
XBSTAT . 
XBTXEMT . 
XINT7201 
XMTBO. . 
XMTBAUO . 
XMTBRK . 
XMTBX. . 
XMTCANCEL 
XMTMTY . 
XMTXOF . 
XHTXON . 
X0N0F1 . 
XONOFF . 
XONOFX . 
XOPTION . 
XRUPT7201 
XSTAT1 . 
XSTATCHC 
XSTATX . 


75# 

75# 

691 696# 

75# 

309 342 

310 343 

75# 216 

305 341 

307 340 

75# 

55# 1197 

59# 1200 

75# 

305 336 

306 337 

75# 174 

304 335 

303 334 

173 302# 

1142 1146# 

524 1136# 

75# 1623 

1139 11 65# 

121 1334 

120 2059# 

75# 479 

75# 1253 

1235 1237# 

525 1232# 

1239 1241# 

91# 2295 

97 170# 

737 755# 

722 726 

742 763# 


703 

705# 

701# 

2299 

693# 

656# 

1 203 


359# 
6 11 # 

724# 

563# 


1950 1973 

2094# 

456 1253 

1610 1621 


16 13 
1 63 1 


1615 1631 

1757 


The Microsoft MACRO Assembler 
End of BIOS 


02-20-54 


PAGE 60,132 

TITLE End of BIOS 

NAME END 


COMPANY CONFIOENTIAL 

Copyright (C) 1953 Digital Equipment Corporation 

All rights reserved. 

cgroup group code 

code segment byte public 'code' 
assume cs:cgroup 

pub 1 i c endb i os 

public packet_adr . xf rpkt , i 55pkt 
public buf f er , t t rack , t format 

pub lie packet . f nccod , St at us . dr vno , secno , t r ackn , nsect . dmaadr . exst at 
public packet__base 


2 1 



; Mere 1 y 

defines the end of 


the BIOS 


22 



; 






23 









24 

< 0400 


packet 

base 

equ this byte 


40Oh 


25 

< 0400 


tt rack"" 

equ 

this byte 

♦ 

400h 


26 

OOOO 

04 t 


db 4 

dup (Offh) 


i 250 

Track pos i t i on 

27 


FF 







25 


1 







29 









30 

8 0404 


t format 

equ 

this byte 

+ 

400h 


31 

0004 

04 I 


db 4 

dup (Offh) 


; 250 

disk type bytes 

32 


FF 







33 


1 







34 









35 









36 

0005 

04 1 


db 4 

dup (Occh) 


; F i 1 

ler 

37 


CC 







35 


1 







39 









40 









41 

8 040C 


packet^ 

adr equ this byte + 


400h 

; Base address of pointers/buffers 

42 









43 

8 040C 


xf rpkt 

equ 

this word 

+ 

400h 

;pointer to “packet" 

44 

OOOC OOOO 


dw 

0 




45 

8 040E 


i55pkt 

equ 

this word 

♦ 

400h 

;returned pointer from 250 

46 

OOOE OOOO 


dw 

0 




47 









)45 



; The packet 

for the z50. 




46 









SO 

8 0410 


packet 

equ 

this byte 

♦ 

400h 

; 250 command packet 

51 

8 0410 


f nccod 

equ 

this byte 

♦ 

400h 


52 

OO10 OO 



db 

O 



; Function code 

53 

8 041 1 


status 

equ 

this byt e 

* 

400h 


54 

0011 OO 



db 

0 



;retnd status. 

55 

8 0412 


dr vno 

equ 

this byte 

* 

400h 




The 

Microsoft MACRO 

Assembler 

02-20-84 

PAGE 

1 - 

2 


End 

Of 8I0S 








56 

0012 OO 



db 

0 




57 

> 0413 


secno 

equ 

this 

byt e 

•f 

400h 

56 

0013 OO 



db 

0 




58 

s 0414 


t rackn 

equ 

this 

byte 

♦ 

400h 

60 

0014 00 



db 

0 




61 

> 0415 


nsect 

equ 

this 

byt e 

4 

400h 

62 

0015 OO 



db 

0 




63 

> 0416 


draaadr 

equ 

this 

word 

♦ 

400h 

64 

0016 0000 



dw 

0 




65 

> 0416 


exstat 

equ 

this 

byt e 

♦ 

400h 

66 

0018 OO 



db 

0 




67 









68 

0018 0200 1 

t 

buffer 

db 200h dup 1 

[OCCh] 



68 


cc 







70 


1 







71 









72 









73 

0218 


endbi os 

label 

byte 




74 









75 

0219 


code ends 





76 









77 




end 






The Microsoft MACRO Assembler 
End of 6I0S 

02-20-64 

PAGE 

Syfflbo 

Segments and groups: 




Name 

Size align 

combi ne 

c lass 

CCROUP 

CODE 

CROUP 

0219 BYTE 

PUBLIC 

' CODE 


Synibo 1 s : 


Name 

Type 

Value 

Attr 


BUFFER 

. . . L 

BYTE 

0019 

CODE 

Globa 

DMAADR 

... E 

WORD 

04 1 6 

CODE 

Globa 

DRVNO 

... E 

BYTE 

04 1 2 

CODE 

Globa 

ENDBIOS 

... L 

BYTE 

02 19 

CODE 

Globa 

EXSTAT 

... E 

BYTE 

04 1 8 

CODE 

C loba 

FNCCOD 

... E 

BYTE 

04 10 

CODE 

Globa 

I66PKT 

... E 

WORD 

040E 

CODE 

G loba 

NSECT 

... E 

BYTE 

04 15 

CODE 

G loba 

PACKET 

... E 

BYTE 

04 10 

CODE 

Globa 

PACKET ADR 

... E 

BYTE 

040C 

CODE 

Globa 

packet"“base 

... E 

BYTE 

0400 

CODE 

Globa 

SECNO 

... E 

BYTE 

04 13 

CODE 

Globa 

STATUS 

. . . E 

BYTE 

04 1 1 

CODE 

C loba 

TFORMAT 

... E 

BYTE 

0404 

CODE 

G loba 

TRACKN 

... E 

BYTE 

0414 

CODE 

Globa 

TTRACK 

... E 

BYTE 

0400 

CODE 

Globa 

XFRPKT 

... E 

WORD 

040C 

CODE 

Globa 


: dr i ve «nd s f d« 

; Track # 

;# of soctors to process 
; DMA address (abs) 

: extended status 
; zao buffer area 


Length >0200 


Warning Severe 
Errors Errors 



End of EIOS 


SyMbel Cross Roforoneo 

■UFFER 

C6R0UF 

CODE 


f# «s doffnltion) Crof-l 

17 •«# 

1 1 13 

11 12# 12 71 


DMAADR 16 63# 

DRVNO 16 66# 


BNDOIOS 16 73# 

EX6TAT 16 66# 


FNCCOD 16 61# 

166FKT 16 66# 


N6ECT 


61# 


RACKET 16 60# 

RACKET AUR 16 41# 

RACKET^RASe 19 24# 


SBCNO 16 67# 

STATUS 16 53# 


TFORMAT 17 30# 

TRACKN 16 69# 

TTRACK 17 25# 


XFRRKT 


1 6 43# 


The Microsoft MACRO Assembler 
MSDOS 2.00 eiOS end System i n i t i e 1 i lat i on 


02-20-64 


PACE 60.132 

TITLE MSDOS 2.00 BIOS and System i n i t i a 1 i zat i on 
NAME BIOSINIT 

COMPANY CONFIOENTIAL 

Copyright (C) 1983 Digital Equipment Corporation 

All rights reserved. 

cgroup group cede 

This module sets the proper packet ptr, initializes 
the bios 10 devices, and sets up SYSINIT. After the DOS takes 


15 
1 6 

17 


; cent r o 1 

, tnis module is 

overwr i 1 1 en . 


s 0040 

bi osseg 

equ 40h 

;where we load BIOS, 


16 

19 

20 
21 
22 

s 4000 

bi OSS i z 

equ 16*1024 i 

igenerous BIOS size. 



pubi ic 

bi osi nit 




extrn 

dev 1st : byt e 



23 


ext r n 

i o i ni t : near 



24 


ext r n 

endbi os : near 



25 


extrn 

hd_i n i t : near 

; Read home, etc 


26 


ext r n 

psTr : near 



27 


ext r n 

packat^base : near 

: locat ion of bios 

data 

26 


extrn 

packet^adr : near 

; 1 ocat i en of new 

packet ptr 

29 


extrn 

dos poTnter:word 

; in MSB I OS 


30 

31 

32 


extrn 

dskdev:werd. hdskdev : near , aux2dev : near , 

xopt i on : byt e 


■SYSINIT 

' externals: 




33 

34 

35 

36 

37 
36 

39 

40 

41 

42 

43 

44 

45 

46 

47 
46 


extrn sysinit:far 


; entry po i nt , 


extrn curr ent^dos_1ocat i on : word .-where the DOS 

; i s loaded . 

extrn f i na l_dos_1 ocat i on : word ;where it will 
~ “* ; res i do , 

extrn dev i ce_1 i st : dwor d ;top of device 

” ;chain. 

extrn memor y_S i ze : wor d ;size. paras, 

extrn def au 1t_dr i ve : byt e 

extrn buffers:byte 

extrn files -.byte 




02-20-S4 


PAQE 


1-2 


The Microsoft MACRO AssoMblor 
MSDOS 2.00 RIOS «nd System Inft isl Isot 1 on 


4t 




pogo 




BO 

oooo 


code sogmont 

byte public 'code' 


SI 




assume cs : egroup , ds : egr oup 


B2 




; 




S3 




; 




B4 




; USEFUL EOUATES 



8S 




; 




88 



c 

Include defs 

. ash 



87 

B 

-0O01 

c 

TRUE EOU 

“ 1 



84 

S 

oooo 

c 

FALSE EOU 

NOT TRUE 


89 



c 





90 



c 





81 



c 

ENDIF 




82 



c 





93 



c 





94 



c 

:Versfon number info 



98 



c 





89 


0002 

c 

VER NO 

EOU 

2 

vers 1 on__number 

87 


0005 

c 

rev“mo 

EOU 

5 

rev__number 

88 


0018 

c 

MOD^NO 

EOU 

24 

mod^number %% update this equate 

89 



c 





70 


OOOO 

c 

CR 

EOU 

OOh 

carriage return 

71 


OOOA 

c 

LF 

EOU 

OAh 

line feed 

72 


0007 

c 

BELL 

EOU 

07H 

Bell character 

73 


0018 

c 

ESC 

EOU 

IBh 

Escape 

74 


0013 

c 

CTRL S 

EOU 

13h 


78 


001 1 

c 

ctrl“*o 

EOU 

1 1 h 


78 


0O1A 

c 

ctrl“z 

EOU 

1 Ah 


77 



c 





78 


01E0 

c 

DOSBASE 

EOU 

01 EOh 

;HSDOS.SYS base segment 

79 



c 





80 



c 

I VRELOC 

EOU 

TRUE 

vector relocate 

81 








82 


FEFO 


Idrdata equ 

OFEFOh 



83 


FFOO 


Idrpkt equ 

Idrdat a -*- 1 oh 

; location of command packet 

84 


FEFC 


xfrpKt equ 

OFEFCh 


iwhere Z80 thinks packet ptr is 

85 


0010 


dot 1 en equ 

OlOh 


; length of disk data and packet 

86 


0025 


pKtfcn equ 

025h 


;move packet function code 

87 


OOOO 


zBOint equ 

OOh 


; z80 1 nt err upt 

88 


000 1 


wprsnt equ 

01 


;W1nn1e present 

89 


0002 


xcprsnt equ 

02 


;Xcomm present 

90 








9 1 








92 




; I n 1 1 i a 1 1 ze 

the BIOS, 

then set the stuff for 

93 




;SYSINIT, and jump to 

1 t . All of 

this code gets 

94 




; over wr 1 1 1 en 




95 








96 




; The boot ed 

disk drive 

is In CX . 


97 








98 

oooo 


biosi nit : 




99 

oooo 8C C8 


raov 

ax . cs 



100 

0002 8E DO 


mov 

ss . ax 



101 

0004 BC 0210 R 


mov 

sp. offset stack 

;temp stack, 

1 02 

0007 8E D8 


mov 

ds . ax 



103 

0009 8E CO 


mov 

es , ax 
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MSDOS 

2.00 BIOS 

and System 

Initial 

1 zat 1 on 



1 04 

OOOB 

5 1 



push 

cx :save 

boot ed dr i ve 

105 








106 





;In1t1a11ze all the hardware, and the 

interrupt vectors. 

107 








1 08 

OOOC 

E8 

OOOO E 


ca 1 1 

ioinit ;setup interrupt vectors (10. ASM) 

109 








1 10 

OOOF 

FB 



St 1 

: Need 

i nt s on 

1 1 1 

OOlO 

33 

CO 


xor 

ax , ax 


1 1 2 

0012 

8E 

CO 


mov 

es , ax ; set 

ES ; too 

1 13 

0014 

IE 



push 

ds ;save 

data segment 

1 1 4 

0015 

8E 

08 


mov 

ds , ax ;and 

set it to 0 too 

1 1 5 

0017 

BE 

FEFO 


mov 

si, offset Idrdata 

;move it from default pkt 

1 1 6 

001 A 

BF 

OOOO E 


mov 

di, off sat packet_base 

;to bios area 

1 17 

0O1 0 

B9 

0010 


mov 

cx, offset dat 1en~° 

; mov all the dat a 

1 1 8 

0020 

FC 



c Id 

; make 

sure we mov it in the right 

1 1 9 

002 1 

F3/ 

A4 


rep 

movsb ;quickmove 

1 20 

0023 

1 F 



pop 

ds ;restore mysterious ds : 

121 








1 22 

0024 

BB 

FFOO 


mov 

bx, offset Idrpkt 

; build packet for move 

1 23 

0027 

26 

C6 07 25 

mov 

byte ptr es : ( bx ] , pkt f cn ;comroand to move packet 

124 

002B 

26 

C7 47 02 OOOO E 

mov 

es:word ptr 2(bx], offset packet_adr 

1 25 

003 1 

26 

C7 06 FEFC FFOO 

mov 

es : xf rpkt , of f set Idrpkt 

126 








1 27 

0038 

E6 

OO 


out 

z80 i nt , a 1 ; ca 1 1 

the z80 

1 28 

003A 

26 

83 3E FEFC OO 

watack: emp 

es:word ptr xfrpkt.O 

; see if any return yet 

1 29 

0040 

75 

F8 


jnz 

watack ;wa1t 

unt 1 1 he does 

1 30 








131 





;Pr1nt the system signon message 


1 32 








1 33 

0042 

BB 

OOE 1 R 


mov 

bx , offset hello 

:pr1nt the hello message 

1 34 

0045 

E8 

OOOO E 


cal 1 

pst r 


135 








1 36 





;Do some preliminary hardware configuration (adjust device table. 

1 37 








1 38 

0048 

80 

3E OOOO 

E 01 

emp 

xopt lon.wpr snt 

;have Winnie? 

1 39 

0040 

75 

13 


jne 

xopt 1 1 


1 40 

004F 

E8 

OOOO E 


cal 1 

hd init 

;yes - call hard disk Init 

1 4 1 

0052 

OA 

CO 


or 

al ,al 

;any units 

1 42 

0054 

74 

OC 


je 

xopt i 1 

; jump i f none 

1 43 

005 6 

BB 

OOOO E 


mov 

bx, offset dskdev 

;po1nt at floppy 

1 44 

0059 

C7 

07 OOOO 

E 

mov 

word ptr 0[bx], offset 

hdskdev 

1 45 

0050 

C7 

47 02 0040 

mov 

word ptr 2[bx], offset 

bi osseg 

146 

0062 

80 

3E OOOO 

E 02 

xopt 1 1 : emp 

xopt i on , xcprsnt 

; extended comm present? 

1 47 

0067 

75 

OC 


j ne 

xopt 1 2 

; jump i f none 

148 

0069 

BB 

OOOO E 


mov 

bx, offset dskdev 

: po 1 nt, at f 1 oppy 

149 

006C 

C7 

07 OOOO 

E 

mov 

word ptr 0[bx], offset 

aux2dev 

150 

0070 

C7 

47 02 0040 

mov 

word ptr 2lbx], offset 

bi osseg 

151 

0075 

B8 

E 


xopt 1 2 : mov 

ax , seg sysinit 

;Setup for SYSINIT 

152 

0078 

8E 

08 


mov 

ds . ax 


153 








154 





assume ds : seg 

sysi nit 


155 








156 

007A 

59 



pop 

cx ; get 

boot ed 

1 57 

007B 

FE 

Cl 


1 nc 

cl ; dr 1 ve , 

188 

0070 

88 

OE OOOO 

E 

mov 

default drive, cl 
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and System initial 1 

sat i on 




IBS 








1 80 

0081 

SC 

C8 


mov 

ax, cs 


181 

0083 

08 

0400 


add 

ax . ( bi OSS i z/ 1 6 ) 


1 62 

0086 

A3 

0000 E 


mov 

current dos location, ax 

183 








164 

0089 

B8 

OOOO E 


mov 

ax, offset endbios ; loc of bios end (above Z80 region) 

1 85 

008C 

B1 

04 


mov 

C 1 , 4 


166 

008E 

03 

E8 


shr 

ax , c 1 

; convert to paragraph 

1 87 

0080 

05 

004 1 


add 

ax, 4 1 h 

* base segment + 1 

1 68 

0093 

A3 

OOOO E 


mov 

f i na l_dos__ loc at i on , ax 

1 69 

0096 

2E 

A3 OOOO E 


mev 

CS : dos_poTnt er , ax ; FORMAT uses this to find MSDOS 

1 70 








171 




; Determine 

memory size (faster than SYSINIT) 

172 








173 

009A 

33 

DB 


xor 

bx, bx 


174 

009C 

BA 

1000 


mov 

dx, lOOOh 

;Start at 64K 

176 

009F 



t st^mem 




176 

009F 

8E 

C2 


mov 

es , dx 


177 

OOA1 

B1 

OE 


mov 

C 1 , 1 4 

;Max # of sections (896K) 

178 

OOA3 

26 

8A 07 


mov 

a 1 , es : ( bx ] 

; get byt e 

179 

OOA6 

F6 

OO 


not 

a 1 

; compliment byte 

1 80 

OOA8 

26 

88 07 


mov 

es : I bx I , a 1 

; wr i t e it back 

1 8 1 

OOAB 

26 

3A 07 


cmp 

a 1 , as : [ bx ) 

; same? 

182 

OOAE 

F6 

DO 


not 

a 1 

; invert it back to original value 

183 

OOBO 

26 

88 07 


mov 

es : [ bx ] , a 1 


1 84 

OOB3 

75 

08 


jne 

done__mem 

;done if no match 

185 

OOB5 

81 

C2 1000 


add 

dx, lOOOh 

; St ep to next 64K 

186 

OOB9 

FE 

C9 


dec 

c 1 


187 

OOBB 

75 

E2 


jnz 

t st__mem 

; loop till done 

188 

OOBD 



done mem; 



1 89 

OOBD 

89 

1 6 OOOO E 


mov 

memor y__s i ze , dx 

DX : s # of paragraphs in system 

190 

OOC 1 

C6 

06 OOOO E 04 


mov 

buff er7 , 4 

;A good number (maybe made larger by user) 

1 9 1 

OOC6 

C6 

06 OOOO E 08 


mov 

f i 1 es , 8 

; Edit CONFIG.SYS to change 

192 








193 




: Set up 

the 

pointer to our chain of ID devices. 

194 




: and leave 

default drive and buffers. 

195 




; 




196 

OOCB 

8C 

OE 0002 E 


mov 

word ptr device list-tz.cs 

197 

OOCF 

C7 

06 OOOO E OOOO E 


mov 

word ptr device list 

offset devist 

198 

0005 

BA 

010C 


mov 

dx, lOCh 

««» Disable MHFU for SYSINIT 

199 

0008 

BO 

OO 


mov 

a 1 , O 

; ; MHFU port 

200 

OOOA 

FA 



c 1 i 


;; Ints off first 

20 1 

0006 

EE 



out 

dx , a 1 

; ; Now d i sab 1 e 

202 

OOOC 

EA 

OOOO E 


jmp 

sys i n i t 

Invoke SYSINIT (ints restore in REINIT) 

203 








204 

OOE 1 



hello 

label byte 


205 




r ept 

0 



206 





db 

'Version ' 


207 





db 

VER_NO+ 'O ' 


208 





db 

' . ' 


209 





db 

(REV N0/1O)+'O' 


210 





db 

(REv“nO MOO 10)+ 

'O' 

2 1 1 





db 



212 





db 

(MOD N0/100)+'0' 


213 





db 

(MOD_NO MOD 100)/104'0' 
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214 

215 

216 

217 OOE1 

2 1 8 

219 

220 
22 1 
222 

223 

224 

225 O1O0 

226 

227 

228 

229 

230 Olio 

231 

232 

233 

234 = 0210 

235 

236 0210 

237 

238 


43 6F 70 79 72 69 
67 68 74 20 31 39 
38 33 20 44 69 67 

69 74 61 6C 20 45 
71 75 69 70 60 65 
6E 74 20 43 6F 72 

70 6F 72 61 74 69 
6F 6E 

OD OA OO 


80 I 

1 


db (MOD NO MOD 10)4-'0' 

db cr , l7 

endm 

db 'Copyright 1983 Digital Equipment Corporation' 


db cr , 1 f , O 

;StacK for booting. 

dw 128 dup (7) 

stack equ $ 
code ends 


end 




Th« Mferoseft NACRO Asscmblsr 02*20-«4 RACE 

MSDOS 2.00 RIOS and Systam f nit fall i«t fen 


Stie 


align combine 


C6II0UR 

CODE 


CROUP 

0210 OYTE PUOLIC 


AUX2DBV 

■ ELL 

BIOSINIT 

B10SSE6 

BIOSSIZ 

BUFFERS 

CR 

CTRL 0 

CTRL S 

ctrl““z 

CURRENT DOS LOCATION . 

OATLEN . . T 

DEFAULT DRIVE 

DEVICE IlST 

OEVLST 

DONE MEM 

DOSBASE 

DOS POINTER 

DSKDEV 

ENDBIOS 

ESC 

FALSE 

FILES 

FINAL DOS LOCATION . . 

HDSKDEV . “ 

HD INIT 

heIlo 

lOINlT 

IVRELOC 

LDROATA 

LDRPKT 

LF 

MEMORY_SI ZE 

MOD NO 

PACKET ADR 

PACKET~BASE 

pktfcn” 

PSTR 

REV^NO 

STACK 

SYSINIT 

TRUE 

TST MEM 

ver”no 


Type 

Value 

L NEAR 

OOOO 

Number 

0007 

L NEAR 

OOOO 

Number 

0040 

Number 

4000 

V BYTE 

OOOO 

Number 

OOOO 

Number 

001 1 

Number 

0013 

Number 

001 A 

V WORD 

OOOO 

Number 

0010 

V BYTE 

OOOO 

V DWORD 

OOOO 

V BYTE 

OOOO 

L NEAR 

OOBO 

Number 

01E0 

V WORD 

OOOO 

V WORD 

OOOO 

L NEAR 

OOOO 

Number 

001 B 

Number 

OOOO 

V BYTE 

OOOO 

V WORD 

OOOO 

L NEAR 

OOOO 

L NEAR 

OOOO 

L BYTE 

OOE 1 

L NEAR 

OOOO 

Alias 

TRUE 

Number 

FEFO 

Number 

FFOO 

Number 

OOOA 

V WORD 

OOOO 

Number 

0014 

L NEAR 

OOOO 

L NEAR 

OOOO 

Number 

002S 

L NEAR 

OOOO 

Number 

0005 

E NEAR 

0210 

L FAR 

OOOO 

Number 

- ooo 

L NEAR 

009F 

Number 

0002 


Attr 


CODE 


CODE 


CODE 


CODE 


CODE 
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WATACK 

WPRSNT 

XCPRSNT 

XFRPKT 

XOPTI 1 

X0PTI2 

XOPTION 

ZBOINT 


L NEAR 

003A 

CODE 

Number 

0001 


Number 

0002 


Number 

FEFC 


L NEAR 

0062 

CODE 

L NEAR 

0075 

CODE 

V BYTE 

OOOO 


Number 

OOOO 



Symbols - 1 

c lass 
'CODE' 

Ext erna 1 
Global 

Ext erna 1 

Externa 1 

External 
Externa 1 
External 


Externa 1 
Ext erna 1 
Ext erna 1 


Ext erna 1 
Externa 1 
Ext erna 1 
Ext erna 1 

Ext erna 1 

Ext erna 1 

Ext erna 1 
Ext erna 1 

External 
Ext erna 1 


Symbo1s-2 


Ext erna 1 


Warning Severe 
Errors Errors 



MSDOS 2.00 II OS and Systam Inft «a1 1 sat f on 


Symbol Cress Safaranea 


(# fs definition) Cref-1 


AUX2DCV 

SELL 

tIOSINIT 

BIOSSCC 

BIOSSIZ 

BUFFERS 

CGROUP 

CODE 

CR 

CTRL 0 

CTRL~S 

CTRL 2 

CURRENT_DOS_LOCATION 

DATLEN 

DEFAULT DRIVE. . . . 

DEVICE IlST 

DEVLST” 

DONE_MEM 

DOSBASE 

DOS POINTER 

DSKDEV 

ENDBl OS 

ESC 

FALSE 

FILES 

FINAL_DOS_LOCATION . 

HDSKOEV 

HD INIT 

heIlo 

lOINIT 

I VRELOC 

LDRDATA 

LDRPKT 

LF 

MEMORY_SIZE 

MOD_NO 

PACKET ADR 

packet“base 

pktfcn“ 

PSTR 

REV^NO 

STACK 

SYSINIT 

TRUE 


30# 

149 


72# 



20 

98# 


17# 

145 

150 

18# 

1 6 1 


46# 

190 


1 1 

51 

5 1 

1 1 

50# 

50 

70# 

225 


75# 



74# 



76# 



36# 

1 62 


85# 

1 17 


44# 

158 


40# 

196 

197 

22# 

197 


1 84 

1 88# 


78# 



29# 

1 69 


30# 

143 

148 

24# 

1 64 


73# 



58# 

6 1 


48# 

19 1 


38# 

1 68 


30# 

144 


25# 

140 


133 

204# 


23# 

108 


80# 



82# 

83 

1 1 5 

83# 

1 22 

1 25 

71# 

225 


42# 

1 89 


68# 



28# 

1 24 


27# 

1 1 6 


86# 

1 23 


26# 

1 34 


67# 



101 

234# 


34# 

151 

154 

57# 

58 

80 


236 


202 


MSDOS 2.00 BIOS and System i n 1 1 *. a 1 i sat i on 


Symbol Cross Reference (# is 

TST^MEM 175# 167 

VER_NO 66# 

WATACK 128# 129 

WPRSNT 86# 138 


def i n i t i on ) 


Cr ef 


2 


XCPRSNT . 
XFRPKT . 
X0PTI1 . 
X0PTI2 . 
XOPTION . 


89# 

88 # 

1 39 
1 47 
30# 


146 

125 

142 

151# 

138 


1 28 
146# 

146 


Z80INT 


87# 127 



Thtt Mfcrosoft MACRO Ass«nb1«r 
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02-20-04 


RAGE 


1 - 1 


24 



c 

include iodef.ash 




25 



c 


Rainbow Interrupt numbers. 


26 



c 


1 -Apr -83 sgs added 

dskio int vector 


27 



c 


19-Mar-83 sgs 

added 

profile int vector [user clock] 


26 



c 


the int profile is 

called by the RTC interrupt service 

for each 

29 



c 


The ax and ds 

register don't need to be saved [done in 

c Ik i sr ] . 

30 



c 







3 1 

X 

0054 

c 

prof i 1e equ 

64h 


100. user interface to clock interrupt 

32 

s 

002C 

c 

c1k_^int equ 

2ch 


60HZ int. 


33 

s 

0005 

c 

dskTo equ 

65h 


direct disk io for format 


34 



c 







3S 



c 


l7-Mar-83 sgs 

changed to include int 20-26 


36 



c 


interrupt 22-24h are duplicated at 42-44h for consistency. 

37 



c 


These are the 

r e 1 ocat ed 

Rainbow interrupts. 


38 



c 


interrupts, 20h-26h 

moved to 40h-46h 


39 



c 


ATTENTION Modu 

les IOINIT and REINIT may have to be 


40 



c 


Changed if int 

vectors 40h to 46h are changed 


4 1 



c 







42 

z 

0040 

c 

vert equ 

40h 


new vert . f r eq . 


43 

t 

004 1 

c 

spare41 equ 

4 1 h 




44 

z 

0042 

c 

spare42 equ 

42h 




45 

z 

0043 

c 

comdma equ 

43h 


DMA Ctrl optional comm, board 


46 

z 

0044 

c 

aux^prn equ 

44h 


7201 comm . /pr i nt or 


47 

s 

0045 

c 

excoffl equ 

45h 


extented comm, option 


48 

z 

004 6 

c 

uart equ 

46h 


new UART vector. 


49 

z 

0047 

c 

z80 equ 

47h 


Z80 i nt er r upt , 


50 

z 

0018 

c 

rom equ 

18h 


new ROM access. 


5 1 



c 







52 



c 


DEC Rainbow 10 

port 

stuff . 


53 



c 







54 

z 

0010 

c 

kdp equ 

lOh 


825 1 dat a port . 


55 

z 

00 1 1 

c 

ksp equ 

1 1h 


8251 status. 



1 

2 

10 
1 1 
12 

13 

14 

15 
1 6 
1 7 
14 

19 

20 
21 
22 
23 


PAGE 

TITLE 

NAME 


to, 132 

- MSOOS drfvar 
10 


Init 1a1 Isat ion 


COMPANY CONFIDENTIAL 

Copyright (C) 1903 Digital Equipmant Corporation 

All rights roservod. 

09/23/03 

cgroup group codo 

codo sogmont toyto public 'code' 
assume cs : cgroup , ds : cgroup 

public ioinit 

extrn r 1 OO ; byt e , xopt i on : byt e 

extrn fast con: near .clHisr : near . sOOisr : near . intret : near 

extrn physd i sk : near , i nthdl : near 
extrn rupt7201 : near , xrupt 7201 : near 

extrn c 1 k^tO^SO : byt e . c 1 k_^1 6^20 : word , c 1k_ad j : byt e . ticker .byte 
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56 

s 

0040 

C 

auxdp 

equ 

40h 

;7201 data. 

57 

s 

004 1 

c 

pr ndp 

equ 

4 1 h 


58 

s 

0042 

c 

auxp 

equ 

42h 

;7201 command. 

59 

« 

0043 

c 

prnp 

equ 

43h 


60 



c 





6 1 



c 

; Values 

i n 

XOPTION 


62 



c 





63 

S 

0OO1 

c 

wpr snt 

equ 

01 

.'Winnie preset 

64 

= 

0002 

c 

xepr snt 

equ 

02 

;XC0MM present 

65 








66 

S 

EEOO 


sysram 

equ 

OEEOOh 

: segment of system RAM 

67 

S 

1FFE 


syspar 

equ 

01 FFEh 

;offset to SYSPAR word 

68 

* 

01O0 


bit8 

equ 

OlOOh 

;Majik bit in SYSPAR 
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RA6C 


1-3 


89 





pago 




70 









71 





; First 

re- init 

the default vectors by invoking ROM serv 

72 









73 

OOOO 




i o i n i t : 




74 

OOOO 

BF 

OOOC 



mov 

di .OCh 

Setup ROM vectors 

78 

0003 

CD 

28 



int 

40 

76 





; 




77 





; get clock rate 

from r em 


78 





; 




79 

0008 

OE 




push 

cs 


80 

0006 

IF 




pop 

ds 

ds ; «bi OS seg 

81 

0007 

BF 

OOOE 



mov 

di . OCh 

return clock rate 

82 

OOOA 

CD 

28 



i nt 

40 


83 









84 

OOOC 

B3 

3C 



mov 

b1 . 60 

assume 60 Hz 

85 

OOOE 

B7 

FD 



mov 

bh. -3 

adjust value 

86 

0010 

BA 

01 AA 



mov 

dx, 426 

0.01 sec add value 

87 

0013 

22 

CO 



and 

a1 ,a1 

o t 60 Hz 

88 

0018 

74 

07 



j* 

c 1k60 


89 

0017 

B3 

32 



mov 

b1 . 50 

it's 80HZ 

90 

0019 

B7 

03 



mov 

bh , 43 


9 1 

001 B 

BA 

0200 



mov 

dx. 512 


92 

001E 




C 1k60 ; 




93 

O01 E 

88 

IE OOOO 

E 


mov 

elk 60 50, b1 

set 60/50 Hz 

94 

0022 

89 

16 OOOO 

E 


mov 

c 1k“l 6~20. dx 

set 0.01 sec add value 

95 

0026 

88 

3E OOOO 

E 


mov 

c 1 k~ad j , bh 

set adjust value 

96 

002A 

88 

IE OOOO 

E 


mov 

t i cker , b 1 

init ticker 

97 

002E 




c Ikxl : 




98 

002E 

FC 




c Id 



99 









100 





;For the Rainbow, we must play horrible games 

101 





;with interrupt 

vectors. Copy the problem 2x 

102 





;vectors elsewhere. 


103 









104 

002F 

IE 




push 

ds 


105 

0030 

06 




push 

es 


106 

003 1 

33 

CO 



xor 

ax . ax 


107 

0033 

8E 

D8 



mov 

ds . ax 


108 









109 





; Set up 

Winnie/Xcemm vectors here 

(also set XOPTION) 

1 10 









1 1 1 

0035 

B8 

EEOO 



mov 

ax. offset sysram 


1 1 2 

0038 

8E 

CO 



mov 

es , ax 


1 1 3 

O03A 

26 

: F7 06 

1FFE 0100 


t est 

es:word ptr syspar,bit8 

1 1 4 

004 1 

75 

1 1 



jnz 

opt nop 


1 1 5 









1 1 6 

0043 

B3 

02 



mov 

b 1 . xepr snt 

assume XCOMM 

1 1 7 

0045 

E4 

68 



i n 

a 1 , 68h 

check Winnie present 

1 1 8 

0047 

24 

EO 



and 

a 1 . OEOh 

1 1 9 

0049 

3C 

AO 



emp 

a 1 . OAOh 


1 20 

004B 

75 

02 



jnz 

xopt i n i 


121 

0040 

B3 

01 



mov 

b 1 , wpr snt 


122 

O04F 




xopt i n i 



123 

004F 

2E 

; 88 1 E 

OOOO E 


mov 

cs : xopt i on , b 1 

set opt i on byt e 
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1 24 

125 0054 

126 0055 

127 0057 

128 0059 

129 

130 005C 

131 0060 

132 

133 0063 

134 0069 

135 006B 

136 0070 

137 0073 

138 0073 

139 0079 

140 007B 

141 0080 

142 0083 

143 0083 

144 0088 

145 

146 008B 

147 008E 

148 0091 

149 0094 
1 50 

151 0096 

152 0099 

153 009C 

154 0090 

155 

156 009E 

157 OOA1 

158 C0A4 

159 OOA5 

160 OOA7 
1 6 1 

162 OOA8 

163 OOAB 

164 OOAE 

165 OOAF 

166 OOB1 
1 67 

168 OOB2 

169 OOB5 

170 00B8 

171 OOBS 

1 72 OOBB 

173 

174 OOBC 

1 75 OOBF 

176 OOC2 

177 OOC3 

178 OOC5 


FA 

33 CO 
8E CO 
BB 0090 

C7 07 OOOO E 
8C 4F 02 

2E; 80 3E OOOO E 

75 08 

C7 47 04 OOOO E 
8C 4F 06 

2E : 80 3E OOOO E 

75 08 

C7 47 04 OOOO E 
SC 4F 06 

C7 47 OC OOOO E 
8C 4F OE 

B9 0010 
BE 0080 
BF 0100 
F3/ A5 

5E OOAO 
BF 0060 
A5 
A5 

BF OOA4 
B8 OOOO E 
AB 

8C C£ 

AB 

BF OOBO 
B8 OOOO E 
AB 

8C C8 
AB 

BF 0190 
B8 OOOO E 
AB 

8C C8 
AB 

BF 0194 
68 OOOO E 
AB 

8C C8 
AB 
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opt nop : c 1 i 

xor 

fflOV 

fflOV 

fflOV 

mov 


ax . ax 
es , ax 
bx , 24h»4 


; I nt s off her e 

; ES : base O 

;base of INT 24 


word ptr 0[bx], offset RUPT7201 ;comm port handler 
word ptr 2[bx],cs 


emp 

jne 

mov 

mov 

not w i n i : 

emp 

jne 

mov 

mov 

not xcoram ; 

mov 

mov 


cs : xopt i on , wpr snt 
not w i n i 

word ptr 4[bx], offset inthdl 
word ptr 6(bx].cs 


; Wi nn i e? 

;Winnie handler 


cs : xopt i on , xepr snt ;XC0MM 

not xcomm 

word ptr 4lbx], offset XRUPT7201 ; XCOMM handler 
word ptr 6[bx],cs 


word ptr 1 2 [ bx ] , of f set zBOisr 
word ptr 14(bxj,cs 


mov cx , 8*2 

mov s i . 20h* 4 

mov d i , vert » 4 

rep movsw 


;8 vectors 

;copy vert.[20h to 27h] 
;to int 40h-47h 


mov si.28h*4 ;move INT 40 

mov d i , r om*4 

movsw 

movsw 


mov di.29h*4 ; set FASTCON 

mov ax, offset fastcon 

St osw 

mov ax.es 

St osw 

mov di,clk_int*4 ; sot RTC , 

mov ax, offset clkisr 

st osw 

mov ax.cs 

St osw 


mov di,profi1e*4 ; set RTC user vector 

mov ax. offset intret ; set to iret 

St osw 

mov ax.cs 

St osw 


mov di,dskio*4 ;disk io. 

mov ax. offset physdisk 

St osw 
mov 
St osw 


ax. cs 
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17f OOCS PR 

1RO 


St I 


;ro*onob1o Ints 
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1S1 

IR2 

1R3 

ISA 

IAS 

1S8 

1R7 


166 

OOC7 

55 


169 

OOCS 

BF 

001 A 

190 

OOCB 

BA 

0109 R 

1 9 1 

OOCE 

8C 

CO 

192 

OODO 

CO 

28 

193 

OOD2 

50 


194 




19S 

0003 

OE 


196 

0004 

IF 


197 

0005 

C6 

06 OOOO E OO 

196 

OOOA 

60 

3E 0109 R OO 

199 

OOOF 

74 

25 

200 




201 

OOE 1 

A1 

0109 R 

202 

OOE4 

66 

C4 

203 

00E6 

30 

3035 

204 

OOE9 

72 

IB 

20S 

OOEB 

A1 

010C R 

206 

OOEE 

66 

C4 

207 

OOFO 

30 

3032 

206 

OOF3 

72 

1 1 

209 




210 




211 




212 

OOFS 

C6 

06 OOOO E 01 

213 

OOFA 

BO 

20 

214 

OOFC 

B4 

AO 

216 

OOFE 

BF 

001C 

216 

0101 

B9 

0016 

217 

0104 

CO 

26 

216 

0106 



219 

0106 

07 


220 

0107 

1 F 


221 

0106 

C3 


222 




223 

0109 

OO 

OO OO OO OO OO 

224 


oo 

OO OO OO OO OO 

226 


00 

OO 


226 

227 0117 

226 
226 


page 

;Interrupt vector relocation checks... 
;checKs to see If rlOO A or rlOO B - 
;if rlOO b then If ROM version 5 . 02+ , then 
;re1ocate vectors 


push 

bp 

mov 

di . lah 

mov 

dx. offset temp 

mov 

bp.es 

Int 

40 

pop 

top 

push 

cs 

pop 

ds 

mov 

byte ptr R100.0 

emp 

byte ptr temp.O 

j® 

loiS 

mov 

ax, word ptr temp 

xchg 

al.ah 

emp 

ax. '05 ' 

jb 

ioiS 

mov 

ax, word ptr temp- 

xchg 

al.ah 

emp 

ax. '02 ' 

jb 

loiS 

have a 

1O0B with current 

mov 

byt e ptr r 1 0O , 1 

mov 

a 1 , 20h 

mov 

ah , OAOh 

mov 

di , ICh 

mov 

cx , 1 8h 

1 nt 

40 

pop 

es 

pop 

ret 

ds 

db 

o 

o* 

o 

o 

o 

o 

o 

o 


;rooke sure frame ptr is preserved 

;Rom version # check command 

;check buffer 

; set frame ptr to roms 

; Invoke firmware 

;and restore the frame ptr 

; set ds to cs for convenience 


;and don't go any further 


: swap bytes? 

;check first rom # 
; just ba i 1 out 
+3 ;get 2nd ROM # 
;swap bytes 
;check other ROM # 


relocate the hardware vectors 


; set up for rom vector relocate 
; and tell the rom 


code ends 


end 
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Segments and groups: 





Name 

S 1 se 

align 

combine 

c lass 

CCROUP 

GROUP 




CODE 

01 17 

BYTE 

PUBLIC 

'CODE' 

Symbols : 





Name 

Type 

Value 

At t r 


AUXDP 

Number 

0040 



AUXP 

Number 

0042 



AUX PRN 

Number 

0044 



BITS 

Number 

0100 



CLKSO 

L NEAR 

00 IE 

CODE 


CLKISR 

L NEAR 

OOOO 

CODE 

Ext or na 1 

CLKX1 

L NEAR 

O02E 

CODE 


CLK IB 20 

V WORD 

OOOO 

CODE 

External 

CLK SO SO 

V BYTE 

OOOO 

CODE 

Ext er na 1 

CLK AOJ 

V BYTE 

OOOO 

CODE 

Ext erne 1 

CLK INT 

Number 

O02C 



COMOMA 

Number 

0043 



DSKIO 

Number 

0085 



EXCOM 

Number 

O04S 



PASTCON 

L NEAR 

OOOO 

CODE 

External 

INTMOL 

L NEAR 

OOOO 

CODE 

External 

INTRET 

L NEAR 

OOOO 

CODE 

Ext er na 1 

lOIS 

L NEAR 

0106 

CODE 


lOINIT 

L NEAR 

OOOO 

CODE 

Global 

KDP 

Number 

0010 



KSP 

Number 

O01 1 



NOTWINI 

L NEAR 

0073 

CODE 


NOTXCOMM 

L NEAR 

0083 

CODE 


OPTNOP 

L NEAR 

0064 

CODE 


PHYSDISK 

L NEAR 

OOOO 

CODE 

Ext er na 1 

PRNOP 

Number 

004 1 



PRNP 

Number 

0043 



PROFILE 

Number 

0064 



R1O0 

V BYTE 

OOOO 

CODE 

External 

ROM 

Number 

00 18 



RUPT7201 

L NEAR 

OOOO 

CODE 

Ext er na 1 

SHVVEC 

L NEAR 

OOPS 

CODE 


SPARE4 1 

Number 

004 1 



SPARE42 

Number 

0042 



SYSPAR 

Number 

1PPE 



SYSRAM 

Number 

EEOO 



TEMP 

L BYTE 

0109 

CODE 


TICKER 

V BYTE 

OOOO 

CODE 

Ext er na 1 

UART 

Number 

0046 



VERT 

Number 

0040 



WPRSNT 

Number 

O0O1 



XCPRSNT 

Number 

0002 



XOPTINI 

L NEAR 

004P 

CODE 


XOPTION 

V BYTE 

OOOO 

CODE 

Ext er na 1 
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XRUPT7201 L NEAR OOOO CODE External 

ZSO Number 0047 

ZAOISR L NEAR OOOO CODE External 

Warning Severe 
Errors Errors 
O O 
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Symbol Cross Roferonco 


(# is definition) Crof-1 


AUXDP S6# 

Auxp se# 

AUX_PRN 48# 

BITS. 68# 1 1 3 

CCROUP 12 15 15 

CLK60 88 92# 

CLKISR 19# 163 

CLKX1 97# 

CLK 18_20 22# 94 

CLK~60 50 22# 93 

CLK”aDJ 22# 95 

CLK~INT 32# 162 

CODE 12 14# 14 227 

COMDMA 45# 


DSKIO 


33# 174 


EXCOM 47# 

PASTCON 19# 157 

INTHDL 20# 135 

INTRET 19# 189 

lOIS 199 204 208 218# 

lOINlT 17 73# 


KDP 54# 

KSP 55# 


NOTWINI 134 1 37# 

NOTXCOMH 139 142# 


OPTNOP 


114 125# 


PMYSDISK 20# 175 

PRNDP 57# 

PRNP 59# 

PROFILE 31# 168 

R100 18# 197 212 

ROM 50# 152 

RUPT7201 21# 130 


SHVVEC 212# 

SPARE4 1 43# 

SPARE42 44# 

SYSPAR 87# 113 

SYSRAM 66# 111 

TEMP 190 198 201 205 223# 

TICKER 22# 96 

UART 48# 

VERT 42# 148 


- MSDOS driver initialization 


Symbol Cross Reference 


is definition) Cref-2 


WPRSNT 63# 121 133 

XCPRSNT 64# 116 138 

XOPTINI 120 1 22# 

XOPTION 18# 123 133 138 

XRUPT7201 21# 140 


Z80 . . 

Z80ISR 


49# 

19 # 


143 
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CHAPTER 1 
INTRODUCTION 


1.1 WHO SHOULD READ THIS DOCUMENT? 

If you are a software developer or documentation writer, read this 
document before starting work on your product. This will ensure that 
international requirements are built in, rather than added after the 
development of a version for one country. 


1.2 WHAT THIS DOCUMENT WILL TELL YOU 

The first chapter of this document gives an overview of topics that 
can affect the final quality of a translated product. These topics 
are then presented in greater detail in the remainder of the document, 
with particular emphasis on developing software for translation and 
writing text for translation. 


1.3 WHY BUILD TRANSLATABI LITY INTO THE DESIGN? 

Sales of digital's products are increasing to users whose native 
language, customs, and conventions are different from those of the 
developers of the product. These users are frequently unfamiliar with 
computers . 

If international requirements are not taken into consideration, 
translation is likely to be difficult and expensive. The key is to 
design a core product that does not have to be altered to be 
trans 1 ated . 

Products to be translated must be developed in three stages: 

1. Identification of all international requirements in the 
f ol lowing categor i es : 
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• Software 

• Documentation 

• Packaging and distribution 


2, Development of the base system to meet the requirements of 
one country/market without putting obstacles in the way of 
i nternational requi rements. 

3 . Adaptation of the base system to meet the requirements of 
other count r i es/markets . 


1.A SOFTWARE 

Your product may appear in one country in more than one language. 
Therefore it may have to include the ability to communicate in more 
than one language, and to switch from one language to another easily. 

Also, functions of many applications differ from country to country. 
This means that different versions of the software will be required. 
For example, an accountancy application must conform to the 
accountancy practices of the target country. 


1 .5 DOCUMENTATION 

The documentation that DIGITAL provides in countries outside the U.S. 
depends on the product and the country. Sometimes only user 
documentation is translated; sometimes nothing is translated. The 
factors that influence translation include: 

• Legal requirements 

• National standards 

• General knowledge of the English language in the target 
country 

• Availability of English-speaking product support and service 
personnel 

• Nature of the product 
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1.6 PACKAGING AND DISTRIBUTION 
Translated products may be packaged as: 

• Distinct versions of a base product. One kit is then 
developed for each language by adapting the base product. 
Each language's version of the product is then maintained and 
supported separately. 

• Translated updates to a base product. This leads to 
logistics problems of support and maintenance once there is 
more than one version of the product in the field. 
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CHAPTER 2 

DEVELOPING SOFTWARE FOR TRANSLATION 

This chapter describes how to design software so that it can be 
translated with a minimum of change to the original product. 

When developing software that is to be translated, follow these 
gu i del i nes : 

• Allow for the full DIGTAL Multinational Character Set. 

• Isolate user text in modules separate from the code. 

• Allow for expansion of the text. 

Specific guidelines are set out in the following sections. 

2.1 CONSTRUCTING TRANSLATABLE SOFTWARE 
The following topics are discussed: 

• Construction of messages and commands 

• How to handle errors 

• Designing Help 

• Representing characters of countries outside the U.S. 


2.1.1 Screen Text 

To make translation easier, isolate all text used to communicate with 
the user. Observe the following guidelines: 
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• Hold all messages as var i abl e- 1 ength strings in separate 
modules or files. Do not embed messages in code. 

• Do not modify messages by overwriting or by inserting English 
text. 

• Try to store messages as one unit. If this is not possible, 
bear in mind the following points: 

- An English message which can be split neatly into, say, 
three parts (see the example below) may not divide neatly 
into the same number of distinct parts after translation. 

- The order in which the different parts can be displayed 
must be completely flexible, to take into account a 
different sentence structure in another language. 

For example, suppose you stored an error message in three 
parts, as fol lows: 

error n 

input exceeds the quantity allowed 
at line n 

and the parts were translated into German. If you then 
wanted to display them in the order: 

Error n, input exceeds the quantity allowed at line n. 

the resulting message in German would be ungrammatical. 

“ Variables for which different values will be inserted at 
run time must be allowed to occur at any point within any 
of the parts of the message. 

- Do not use the same piece of text in different contexts. 
Although the text may be the same in English, it may be 
different in another language. For example, consider the 
two messages: 

Printer has been disconnected 
Device has been disconnected 

If the text "has been disconnected" was stored as one 
unit, and the words "Printer" or "Device" were inserted 
as appropriate, there would be no problem in English, but 
in French the participle "disconnected" would have to 
agree with the gender of the noun; and in this case the 
nouns have different genders. 
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• Follow the GUIDELINES FOR WRITING TEXT in Chapter 3- 

Because translated text is frequently longer than the original (it may 
occupy 25 % to 50 % more space), it is important to take the following 
points into consideration: 

• If you want to display text at a particular position on the 
screen, do not store the position in the code. The length of 
the text will almost certainly change when it is translated; 
therefore the system may need to display the translated text 
at a different position on the screen. 

You could either: 

- store the position in the same file as the text. This 
can be changed when the text is translated. 

- use the length of the text as a parameter for calculating 
its display pos i t i on . 

An example of a routine which must be able to handle 
differing lengths of text is one which centres text: 

Eng 1 i sh vers i on: 


RAINBOW 100 

Diskette Copy Program VI. 0 
Press EXIT to qu i t 


French version: 


RAINBOW 100 

Programme de copie de disquette VI .0 
Appuyez sur <S0RTIE> pour terminer 

• A routine that displays text must be capable of handling more 
than one full screen of text at a time. In addition, you 
must design the routine to allow the user to display the text 
one page at a time. 

• Tables that are very tightly packed with information are 
difficult to format on the screen when translated. In order 
to accommodate the table on the screen, the translator may be 
obliged to use obscure abbreviations. 

One solution is to split the table into several different 
displays on separate screens. Another is to arrange the 
table in rows as opposed to columns. 
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For example, use: 


Surname ! n n 

f 

Age ! n n 

! 

National i ty ! n n 

! 

Date of B i r th ! n n 

! 

Occupation ! n n 

! 

Salary ! n n 


rather than: 


n 

n 

n 

n 

n 

n 


n 

n 

n 

n 

n 

n 


Surname Age Nationality Date of Birth Occupation Salary 


n n n n n n 

n n n n n n 

n n n n n n 

n n n n n n 

n n n n n n 


2.1,2 Commands 

Making commands easy for the user to understand also helps 
translation. Employ the user interface that the system supports for 
commands, and observe the following guidelines: 

• All command names, qualifier names, and qualifier values must 
be tabl e~dr i ven, so that they can be easily replaced with 
translated text. 

• Checking of user responses must be table-driven. 

• Consider the implications of translation before using English 
sentences as input. For example, can the software be 
modified easily to recognize that ‘'ouI“ is the same response 
as “yes"? 

Use one or more of the following methods to select commands from 
menus : 
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• Positioning the cursor on the command. 

• Selecting a number. 

• Selecting the one or more letters of the command. In this 
case check the letter or letters against a table of valid 
commands. Do not hard-code them. Allow also for the 
selected letter (s) to occur at any position within the 
command, since after translation, several commands in a menu 
might start with the same word. Remember that you may need 
to use more letters to make the translated command unique. 


2 . 1.3 Hand 1 i ng Errors 

Use the system-supported user interface for reporting errors. 
Ensure that the error handler can use parameters in any order. 

2.1.^ Des i gn i ng Help 

Follow the GUIDELINES FOR WRITING TEXT in Chapter 3 . 


2 . 1.5 Representing Characters Of Countries Outside The U.S. 

There are two main ways in which products running on DIGITAL hardware 
represent alphabetic characters not present in ASCII. 

1. Using the DIGITAL Multinational Character Set. This is the 
way that new software products represent alphabetics not 
present in ASCII. The DIGITAL Multinational Character Set is 
represented using 8 bits. 

2. Using the 7“bit codes standardized for the relevant countries 
(just as ASCII is the U.S. standard). These codes are 
indistinguishable from ASCII. Up to 11 characters that 
appear in ASCII are replaced by other characters depending on 
the language being represented. These character sets are 
called National Replacement Character Sets. They are used 
extensively in Europe. The Rainbow 100+ supports the NRC 
sets for applications doing CONSOLE IN/CONSOLE OUT (level 2) 
character I nput/Output. 

For character-coded data in particular, your software should; 
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• Not mask the 8th (most significant) bit of a byte, or use it 
for special purposes, if the byte may contain character data. 

• Permit at least all graphic characters in text literals and 
comments. 

• Allow collating sequences to be table-driven. To be 

completely accurate, collation needs to use a two-character 
lookup, because, for example, German o-umlaut is regareded as 
"oe" and u-umlaut is regarded as "ue". 

Appendix B lists the characters that you should use when characters in 
addition to the Sk graphic characters of ASCII are needed. 


2.2 LANGUAGE ISSUES RELATING TO FORMATS 

The format of certain types of information varies from language to 
language. This section indicates how to take some of these different 
formats into consideration, including: 

• Numbers 

• Dates 

• Time 

• Currency 

• Addresses and telephone numbers 

• Proper names and titles 


2.2.1 Numbers 


Numbers may be displayed in several formats. Ensure that the user can 
vary the format, and that any default can be changed to suit the 
target language. 

The format of a number may include any of the following: 

• + or blank indicating a positive number, or - indicating a 
negative number. 

• The + and - may be either prefix or suffix - Prefix signs are 
always directly beside the first significant figure. 
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• Parentheses denoting a negative number. For example, (2356) 
equals -2356. This convention is chiefly used in financial 
appl i cat i ons . 

Numbers may be separated in two ways: 

1. Thousands - period, comma, null. 

For example: 

2 . 3^5 
2 , 3^5 
2 3^5 

2, Decimal point - period, comma. 

For example: 

1 . 3^ (Engl i sh) 

1,3^ (Continental European) 

If your product allows numbers to be entered in a tabular form, do not 
separate individual table entries with a period or comma. Instead, 
use a space or a semicolon. For example: 

123.^56 876.886 956.907 
892.65^ 17^.987 217.767 
563.982 786.653 5^3.921 
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2.2.2 Dates 


Where your product displays the name of a day or month as letters, you 
must allow sufficient storage and display space to accommodate these 
names in other languages. 

For example, this table shows the maximum number of characters you 
must reserve for storage and display for French, German, and Dutch. 
Note that month names are not always abbreviated. 



French 

German 

Dutch 

Longest day name 

8 

10 

9 

Longest month name 

9 

9 

9 


The position of each component in a displayed date may be varied or it 
may be omitted completely. The components required are described 
below. 


• YEAR - 2 or A digits (two digits are frequently used) 

• MONTH NUMBER ~ number in range 1 to 1 2 

• MONTH NAME - Allow enough space for the name of the month not 
to be abbreviated, because, for example in French, a 
three-letter abbreviation of month names results in confusion 
between “juin" and “juillet" 

• ORDINAL-DAY NUMBER - day number as an ordinal. For example: 

1st 2nd (Engl i sh) 

ler 2 (French) 

1. 2. (German) 

• ORDINAL-DAY - day number as an ordinal in words. For 
exampl e: 

First, Second (English) 
premier, deux (French) 
ersten, zweiten (German) 

• ARTICLE - for example: the, le, den 

• DAY NAME - Sunday through Saturday (English) 

dimanche through samedi (French) 

Sonntag through Sonnabend (or Samstag) (German) 

• DAY NUMBER - 1 through 31 
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• Components may be separated by various editing characters 
including (at least) hyphen, comma, period, space, and slash. 

For example: 

26-Feb-8A (DIGITAL standard format for dates) 

jeudi le premier mars 1984 
14/12 84 
84.11.17 
6/27/84 
1/5 

March 1984 

Saturday 3^*^ March 

Donnerstag (German, Thursday) 

Because some formats lead to confusion between the day and the month, 
it is best to use a format that includes the month name. 


(European) 

(ISO Standard) 

(USA) 

(means 1st May or 5th January) 


2.2.3 Time 

Time may be displayed in either a 12-hour or 24-hour format. A time 
comprises a number of components: 

• HOURS “ One or two digits. Give the option to have a blank 
or a leading zero. 

• MINUTES - Two digits with leading zero displayed. If the 

HOURS field is absent, a leading zero may be suppressed. 

• SECONDS - Two digits with leading zero displayed. If the 

MINUTES field is absent, a leading zero may be suppressed. 

• 1/100 SECOND - In the absence of other components, these are 

displayed in the form 00 . nn. In conjunction with other 

components, the 1/100 seconds follow the second component, 
separated by a period. For example, four minutes, three and 
one-half seconds past two is displayed as 02:04:03*50 in 
24-hour clock format. 

The HOURS, MINUTES and SECONDS components must always appear 
in the order shown and no gaps are allowed. That is, HOURS 
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and SECONDS is not allowed but HOURS and MINUTES is. 

• AM/PM - AM indicates morning. PM indicates afternoon. These 
are used in 12-hour systems only. They are always shown as 
capital letters. In some Scandinavian countries, M is used 
to indicate noon. 

• ZONE - allow up to four characters to indicate the time zone. 

For example: EST, GMT, MST, CET. 

• Separating characters may be placed between the components. 
These include period, colon, comma, space, and null. 


For example: 

1 1 P.M. 

13:56:08.40 
14. 06 hours, GMT 

A combination of date and time can also be shown in ISO (International 
Standards Organization) format. The standard ISO format is a 
l4-character numeric string, which can be stored as: 

YYYYMMDDHHMMSS 

This shows year, month, day, hour, minute, and second with no 
separating characters, although leading zeros may be inserted in the 
string where an entry is less than 10. The time is specified on a 
24-hour clock, according to the standard specified by the local time 
zone. Do not assume a time-zone differs from your time-zone by an 
integral number of hours: for example, Newfoundland, Canada is 

normally 1 hour 30 minutes later than Eastern Standard Time. 
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2.2.4 Currency 

A number may be displayed as an amount of money using the following 
components: 

• A text string of up to four characters - for example, $, Fr, 
or pts. The text string may occur before or after the 
numbers . 

• Sign placement - prefix floated or suffix 

• Decimal point character 

• Thousands character 

• Number of fractional decimal places 

• Scaling factor (normally 1) 

The decimal point and the thousands convention for currencies may 
differ from those used for numbers. For example, French usage is 
1 . 746,23 for numbers but can be Frl746.23 for money. 

For any currency, there may be suffixes after integer amounts which 
indicate that the preceding number will be scaled before use in 
arithmetic. For example, thirty U.S. cents needs to be divided by 
100 to give .3 in dollars ($0.30). This is indicated by a scaling 
factor of 0.01. This method could also be used to handle, say, 
millions of dollars ($M) by using a scaling factor of 1,000,000. 

Note also that the characters and digits representing some currencies 
expand on conversion, and therefore require more display space. For 
example: $1 becomes I 38 O lires. You may also need to distinguish 

between the currencies of countries that use similar names. For 
example, US dollars and Canada dollars; French francs and Swiss 
francs . 
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2 . 2.5 Addresses And Telephone Numbers 

Allow sufficient space for different layouts of addresses and 
telephone numbers. 

• The order of the components of an address differs from 
country to country. 

For example, 

Eng I and 

Mr S. B. Turner, 

55f High Street, 

Grantham, 

L i ncol nsh i re, 

GRl OBT 
Eng I and 


Germany 

Herr Dipl. Ing. Schmidt (title, professional title, surname) 
Stol berger strasse 90 (street, number) 

D-2000 Hamburg 55 (post code, town, district code) 

FDR (country) 


France 

Madame Dupont Claudette (title, surname, first name) 

I7» Hue Louis Guerin (number, street) 

F-69626 Lyon~Vi I I uerbanne (post code, town, suburb) 
France (country) 


NOTE 

Not all post codes are numeric. For example: 

RG2 OSU 


• Not all telephone numbers are the same length or have the 
same format. Telephone numbers often include special 
characters to separate different components. Commonly used 
separators are square brackets, parentheses, hyphens and 
spaces. For example: 

[1]- (603) -884-1234 


(title, initials, surname) 
(number, street) 

(town) 

(county) 

(post code) 

(country) 
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(073^) 868711 

Note also that the same number could be represented in 
different ways depending on whether it was for national or 
international use. For example: 

National (O 89 ) 9591-2323 


international +kS 89 9591 2323 

The means that you should dial your own international 
prefix. This varies from country to country. 


2.2.6 Proper Names And Titles 

Allow for non-a 1 phabet i c characters in proper name and title fields 
(for example, accented letters, apostrophes, and hyphens), to take 
into account users with names such as de la Bassetiere, D’Agostino, 
Tor res-Ferrer . Allow for different formats in title fields, to take 
into account such titles as Herr Dipl. Ing. 


2.3 LANGUAGE ISSUES RELATING TO CHARACTER SETS 

This section covers three types of collating sequence, and refers to 
the DIGITAL Multinational Character Set used by the Rainbow personal 
computer . 


• Character string comparisons 

• Collating the DIGITAL Multinational Character Set 

• Collating sequences for European countries 


2.3*1 Character String Comparisons 

Where collated output is not required, character strings are collated 
according to the numerical ordering of the DIGITAL Multinational 
Character Set. This can occur, for example, in programming languages, 
indexed file key processing, sort/merge and other utilities. 
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2.3*2 Collating The DIGITAL Multinational Character Set 

These rules are used where the language of the text is not known: 

• The letters AE diphthong, 0 with slash and A with ring, 
appear in that order, after Z. 

• The letter N with a tilde accent appears immediately after N. 
It is treated as a separate letter falling between N and 0. 

• German small sharp s and OE ligature are treated as 
2-character sequences, "ss" and "OE" respectively. If 
storage or efficiency is a problem, then German small sharp s 
is treated as a separate letter between s and t, and OE 
ligature is treated as a separate letter between the N with a 
tilde accent and 0 . 

Apart from the letters listed above, the letters in the Multinational 
Character Set are treated as groups of letters with the same basic 
collating value. Within a group, small letters are ordered according 
to their numeric value, and capital letters immediately follow the 
corresponding small letter. For example, the group for the letter A 
i s : 


Sma ] ] 

a 




Cap! tal 

A 




Sma 1 ] 

a 

wi 

th 

grave 

Cap! tal 

A 

wi 

th 

grave 

Sma 1 1 

a 

wi 

th 

acute 

Capi tal 

A 

wi 

th 

acute 

Smal ] 

a 

wi 

th 

c i rcumf 1 ex 

Capi tal 

A 

wi 

th 

c i rcumf 1 ex 

Smal 1 

a 

wi 

th 

tilde 

Capi tal 

A 

wi 

th 

tilde 

Sma 1 ] 

a 

wi 

th 

d i aeres i s/umlaut 

Capi tal 

A 

wi 

th 

diaeresis/umlaut 


The whole group is viewed as being equivalent to A. 
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2. 3*3 Collating Sequences For European Languages 

Unless the rules for a particular language state otherwise, the 

following rules apply: 

• AE diphthong and OE ligature are treated as 2-character 

strings, "AE" and "OE" respectively. 

• German small sharp s is treated as the 2-character string 

"ss". 

• N with tilde, 0 with slash and A with ring are treated as if 
they were separate characters with diacritical marks. 

• All letters with diacritical marks are treated as for 

collating the Multinational Character Set, as described in 
Section 2.3*2. 

Dutch, English, French, Italian, and Portuguese have no additional 
rules . 


Although the above rules apply generally, there may be some exceptions 
in certain countries. For example, some countries have special rules 
for collating proper names. For instance, when collating proper names 
in German, A with diaeresis/umlaut, 0 with diaeresis/umlaut and U with 
diaeresis/umlaut are treated as 2-character strings, "AE", "OE" and 
"UE" respectively. 


Danish and Norwegian: 


• U with diaeresis/umlaut is treated as if it were Y. 






A with diaeresis/umlaut is treated 
d i phthong . 

0 with diaeresis/umlaut is treated as 
si ash . 


as if it were AE 
if it were 0 with 


• AE diphthong, 0 with slash and A with ring appear as separate 
letters, in that order, after Z. 


Finnish and Swedish: 


• U with diaeresis/umlaut is treated as if it were Y. 


• 0 with 

s 1 ash 

is treated as if it 

were 

0 

wi th 

d i aeres i s/uml aut 

• 




• A with 

ring. 

A with diaeresis/umlaut 

and 

0 

wi th 

d i aeres i s/umlaut 

appear as separate letters 

» i n 

that 

order , 


after Z. 
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Span! sh: 


• All letters with diacritical marks, except N with tilde, are 
treated as though the diacritical mark is not present. 

• The string CH is treated as a single letter between C and D. 

• N with tilde is treated as a single letter after N. 

• The string LL is treated as a single letter between L and M. 


2.k DIACRITICAL INSENSITIVITY IN SEARCHES 

Some text editors use a technique called “diacritical i nsens i t i v i ty“ 
in searches. Just as case- i nsens i t i ve searching allows small “a“ to 
match capital “A”, d i acr i t i ca 1 - i nsens i t i ve searching allows “a" 
without a diacritical mark to match “a“ with a diacritical mark. 

If your product uses the Multinational Character Set, diacritical 
insensitivity could be included as a function in string-matching 
algorithms. However, the user must be given the option of disabling 
this function. 

If the editor is in case- i nsens i tive mode, the tables for upper- and 
lower-case are effectively combined. Thus, a search for “a“ will 
match every capital and small “a", with and without a diacritical 
mark . 

The correspondences between characters for d i acr i t i ca 1 - i nsens 1 1 i ve 
searching are listed in Appendix A. Note that although a search for 
upper-case “A" will match upper-case “A*' with a diacritical, the 
converse is not true. A search for upper-case “A" with a diacritical 
will NOT match upper-case “A“. 
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CHAPTER 3 

GUIDELINES FOR WRITING TEXT 


A clear writing style is of utmost importance in any technical text, 
especially if the text is to be translated. 

Errors produced during translation can sometimes be attributed to 
inconsistent vocabulary and poor sentence construction in the original 


text, combined with a 
trans 1 ator . 

lack of technical knowledge 

on 

the 

part 

of 

the 

This chapter describes 

how to design screen text 

for 

trans 1 at i on, 

and 

how to improve the 

quality of printed text. 

It 

al so 

out 1 i nes 

some 

areas which require 

spec i a 1 cons i derat i on 

when 

wr i t i 

i ng 

for 

translation. 







The following DIGITAL 

publications discuss more 

fu 

lly 

some 

of 

the 


topics covered in this chapter: 

• Writing for the Reader 

• Personal Computer Documentor’s Guide 

• Software Publications Style Guide 
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3.1 DESIGN OF SCREEN TEXT 

Wei 1 -des i gned screen displays make any software product simpler, and 
more pleasant to use. They also make translation easier. 


3 . 1.1 Text Of Restricted Length 

Screen text is often restricted in length. For example, an error 
message may be restricted to one line of the screen. Allow for the 
translated version being at least 30% longer than the original. 

For single sentences or phrases, try to reserve at least 50% extra 
space; otherwise you impose restrictions on the translation that could 
result in an ambiguous, or even meaningless, translated message. 

Do not, however, restrict the length of the original English, in order 
to end up with a short translated message. Always use as many words 
as are necessary to make the original message unambiguous. 

If you do need to abbreviate an English message, supply the translator 
with the full text, and tell him what the restrictions on the length 
of the message are. 

Other ways of shortening text may cause problems in another language. 
For example: 

• Acronyms 

Do not use acronyms, because they cannot be translated. If 
an English acronym is retained in a foreign language, there 
is a risk that it might be similar to a word with negative 
associations. 

• Abbreviations 

In general, avoid abbreviations. 

In particular, avoid abbreviating words that will remain in 
English. A translator could easily misinterpret such 
abbreviations. It is acceptable to use internationally 
recognized (SI) unit symbols for units of measurement. 


3 . 1.2 Short Words 

Short, common words are easier to read and understand. Do not use 
computer jargon. It can confuse and intimidate users. 
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Use 


Instead of 


assist, help 

change 

start 

end 

improves 

show 

stop 

use 

wrong 


f ac i 1 i tate 
modi f i cation 
activate, i n i t i ate 
terminate 
enhances 
demonstrate 
di sconti nue 
employ, utilize 
erroneous 


Use a short word in place of a long one only when you are sure that 
the two words convey exactly the same meaning. In some cases, a 
longer word may provide a clearer contrast with some other term you 
have used, or may provide a more precise meaning. In these cases, it 
is better to use the long word. 


3.1.3 Short Sentences 

Brief, simple sentences are generally easier to understand than those 
with several clauses. 

When designing menu items and error messages, beware of omitting words 
for the sake of brevity. For instance, do not omit “the“ or "a“. 
This telegraphic style may make it impossible for the translator to 
tell whether a word is being used as a verb, an adjective or a noun. 

For example, does "set to lock at next level" mean "set to the lock 
which is at the next level" or "set this so that it locks at the next 
1 evel "? 

This style can also obscure who is to perform a certain operation, or 
the time at which it is performed. For example: "scratch files 
deleted? (Yes or No)" might mean "have you deleted the scratch 
files?" or "do you want the scratch files to be deleted?". 


3.1.^ Affirmative Sentences 

Affirmative statements are generally simpler to understand than 
negative statements. Using this form clarifies the meaning and helps 
the translator to make an accurate translation. 

Use Instead of 

Complete your entry before Do not return to menu before 

returning to the menu. completing entry. 
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3.1.5 Active Voice 

The active voice is usually easier to understand than the passive 
voice. Chapter 7 of the DIGITAL publication Writing for the Reader 
discusses the use of voice in detail. 

Use Instead of 

The EXAM switch verifies the The contents of memory are verified by 

contents of memory. the EXAM switch. 


3.1.6 Strings Of Nouns 

Do not string nouns together as if they were adjectives, to produce 
long titles or names. Often, it is not clear which words qualify 
which. Such titles and names are hard to read and often almost 
impossible to translate. 

Use Instead of 

A form for sorting the table Table Sort Description Form 


3.1.7 Stacking Words 

Do not stack words. Stacked words require more eye movements and make 
text harder to read. 

Use Instead of 

Employee's Name: Employee's 

Name: 

In addition, stacked words can lead to misinterpretation on the part 
of the translator, who may not realize that the words are to be 
translated as one unit. For example, if a part of a diagram were 
1 abel 1 ed ; 

Possible Load 
Exclusion Records 

the translator could interpret this as two distinct items. This would 
lead to a mistranslation. 
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3.1.8 Displaying Columns And Alphanumeric Character Strings 

Three to five spaces between columns make data, especially numbers, 
easier to read. 


Use 



Instead of 

1066 

1840 

1918 

1066 1840 1918 

]kS 2 

1877 

1928 

1492 1877 1928 

1563 

1901 

1929 

1563 1901 1929 

1701 

1907 

1963 

1701 1907 1983 


Where appropriate, put strings of 
make them more legible. 

Use 

ABCD 123 ^56 789 
BCDE 23^ 567 890 
CDEF 3^5 678 901 


Iphanumeric characters in groups to 


Instead of 

ABCD 123^56789 

BCDE 23^567890 

CDEF 3^5678901 


3.1.9 Standardize Input Of Data 

Standardize input of data for consistency and minimum confusion. Try 
to use an unambiguous format for dates. Use the month names, but make 
sure that the product can accept the translated names. 

Use Instead of 

Date of Birth: 24 /July /55 Date of Birth: 24 / 07/55 

Date of Hire: Ol/February /79 Date of Hire: February 1 , 1979 


3.1.10 Aligning Lists And Displays 

Generally, left-aligned, vertical lists increase legibility. 


Use 


Instead of 


Monday Monday, Tuesday, Wednesday, 

Tuesday Thursday, Friday 

Wednesday 

Thursday 

Fr i day 
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Data-entry fields often have two parts: a name, and a part that the 
user can modify. If both parts are left-aligned, the text is usually 
more legible. 


Use 


Instead of 


Account Name: 
Street Address: 
City, State: 
Post Code: 


The Widget Company 
123 Maple Street 
Boston, MA 
02100 


Account Name: The Widget Company 

Street Address: 123 Maple Street 

City, State: Boston, MA 

Post Code: 02100 


3.1.11 Use Of Capital Letters 
Use a mixture of capital letters 
Use 

Text containing capital letters 
and small letters is easier 
to read than text containing 
all capital letters. Use capital 
letters sparingly to HIGHLIGHT 
special terms. 


and small letters for running text. 
Instead of 

ALL CAPITAL LETTERS ARE MUCH 
HARDER TO READ THAN A MIXTURE OF 
CAPITAL LETTERS AND SMALL LETTERS. 
THE WORDS BLEND TOGETHER AND LOSE 
IMPACT. 


3.2 IMPROVING THE QUALITY OF PRINTED TEXT 

This section presents guidelines for improving the quality of the 
English text of technical manuals. These guidelines apply at all 
times, not only when writing text for translation. Any increase in 
writing quality will help the translator. 


3.2.1 Logical Sequence 

Describe events in the order in which they occur. A logical sequence 
helps to keep the meaning clear and makes the translator's Job easier. 

Use Instead of 

Select the line number and Press DO after selecting the line 

press DO. number. 
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3.2.2 Consistency 

Keep to one idea within each paragraph or section. Try to keep to one 
tense and person within each book. Use the passive voice selectively. 

Try to identify the typical user of the manual and choose the most 
suitable tense and person for that user. Generally, keep to this 
throughout the manual. Follow these guidelines: 

Use only one term to refer to the same concept. 

Do not use slang or jargon. 

Use terms consistently: 

- wi th i n a manua 1 

across manuals 


Remember that although the translator’s command of English should be 
high, he or she encounters the text in circumstances very different 
from those of the English-speaking user. For instance, the translator 
will not always have the opportunity to experiment with the product in 
the way a user does. 

Maintain your own glossary of terms with special meaning, and give a 
copy of this to the translator. Include titles of applications, 
routines, and specialized terms. Where possible, check that your use 
of terms is consistent with their use in other manuals. It is 
possible that the translator may refer to, or be familiar with, other 
related technical manuals. 


3.2.3 Coherence 

Always try to link the sentences in a paragraph, using words such as, 
"also", "but", "however", "similarly", and so on. Chapter k of 
Writing for the Reader discusses in detail how to achieve coherence in 
your writing. 

Since it is possible that the translator will not have access to a 
computer, or to the product you describe, the translator cannot 
experiment with the system and may not be able to form a mental 
picture of some of the things you describe. If there are two possible 
meanings to what you are saying, the translator will have to render 
one of the two meanings into the foreign language. For example, 
consider the following use of the word "may": 

Strings must have matching quotation marks or no 
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quotation marks at all, and numbers MAY have quotation 
marks. 

This is open to the following interpretations: 

... and numbers must not have quotation marks. 


or 


... and numbers do not necessarily have to have 
quotation marks. 

Clearly, if the translator chooses the wrong interpretation, the 
meaning of the sentence is changed dramatically. Even if your text 
appears clear to an English-speaking reader, always try to look for 
any possible ambiguity, which could lead to m i s i nterpretat i on by the 
trans 1 ator . 


3.2.4 Sentence Construction 

Use short introductory clauses. This places little strain on the 
reader’s short-term memory. 

Place the subject and verb of a sentence as close together as possible 
and use short sentences of 25 words or less. If you have to use a 
long sentence, use commas to clarify your meaning. 

See Chapter 6 of Writing for the Reader for a discussion about how to 
avoid writing complex sentences. 


3.2.5 Clar i ty 

When writing English text, try not to use two words together that have 
more than four syllables. 

Do not use two or more negative words in the same sentence. Use words 
with a concrete meaning, rather than abstract words. 

Do not use abbreviations and acronyms. 


Do not use Latin abbreviations, terms or phrases. Instead, use the 
following equivalents: 


c, ca, circa 
cf . 

e.g. 

etc . 


about 

compare 

for example; for instance 
and so on; and so forth 
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i .e, that i s 

via by means of; by using 

viz. namely 


3.3 SPECIAL CONSIDERATIONS FOR TEXT TRANSLATION 
This section covers: 

• Culturally specific examples 

• Text concerned with handling language 

• Use of tables, diagrams, and figures 


3.3*1 Culturally Specific Examples 

The methods described in Section 3*2 were concerned with clarifying 
meaning for the translator. But there are also ways in which text, 
when translated literally, may be less suitable for a reader in 
another country than for an English-speaking reader. For example: 

To clarify a new concept, you give an example from everyday life, 
which uses terms of reference with which readers in your own country 
are familiar. For example, you might show how a particular accounting 
package can be used to calculate mortgage repayments. A literal 
translation of the example will only confuse readers in countries 
where a mortgage system is not in use. 

If there is no alternative but to give specific examples that are 
unique to their country of origin, ask the translator to substitute as 
much as possible of the example with local language equivalents. 

Draw up a list of words or phrases that need adaptation, and include a 
specific note if anything in the original must be retained. For 
example, you might want measurements changed as a general rule, but 
the word ‘inches' kept to refer specifically to the number of 
characters per inch put out by a printer. 

Avoid using puns, metaphors, and similes. It is always difficult, and 
sometimes impossible, for the translator to find a suitable equivalent 
for these in another language. 
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3.3*2 Text Concerned With Handling Language 

If you describe any operation that involves the order of words in a 
phrase or the characters in a word, any example you give will almost 
certainly have to be adapted or rewritten for translation. If you 
gave as an example, a list of items rearranged in alphabetic order, a 
translation of the MEANING of those items would not result in words 
beginning with the same initial letters. The example would therefore 
be meani ngl ess . 

If your list began with the words: apples, bananas a literal 

translation into French would result in: pommes, bananes 


One possible way round this problem might be to use proper names, for 
example girls' names (Anna, Beatrice, Cleopatra...) which would retain 
the same initial letters after adaptation into the target language. 
The attention of the translator must be drawn to special examples like 
this. 


Here are further examples of topics that give rise to the same kind of 
problem: 

• Changes made to a word using the editor. 

Eng 1 i sh example: 

In the phrase 'a letter form Graham', to change the word 
'FORM' into 'FROM', place the cursor over the 'O', type 
'R', move the cursor one place to the right, press the 
"delete character" key. 

Literal translation: 


In the phrase ' (a) formulaire a lettres Jacques', to change 
the word 'FORMULAIRE' into 'DE', place the cursor over the 
'O', type 'R', move the cursor one place to the right, 
press the "delete character" key. 

The translator will obviously be aware that following these 
instructions will not produce the word DE. However, there is 
not sufficient information available for the translator to be 
able to adapt the example. In cases such as this, highlight 
the example, and give the translator enough information to be 
able to supply an equivalent example in the target language. 
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• Use of "wildcards" to search for words without specifying 
certain character positions. 

Engl i sh example: 

If you specify 'search for ????B0R0', WESTBORO, EASTBORO 
will be found, NORTHBORO will not. 

Literal translation: 

(If you specify) '(Search for) ????STADT', WESTSTADT, 
OSTSTADT (will be found,) NORDSTADT (will not.) 

Highlight examples like this for the translator, and ask that 
they adapt them to make sense in the language of the 
applicable country. 

• File names made unique by judicious choice of the first word 
of the name, so that only a few keystrokes are necessary to 
i dent i f y the file. 

Engl i sh example: 

If you call your reports REPORT FOR MAY, REPORT FOR JUNE, 
and so on you will have to type the whole name to identify 
each document. Using MAY REPORT, JUNE REPORT, and so on, 
you need only type the first word. 

Literal translation: 

(If you call your reports) RAPPORT MENSUEL DE MAI, RAPPORT 
MENSUEL DE JUIN, (and so on you will have to type the whole 
name to identify each document. Using) RAPPORT MENSUEL DE 
MAI, RAPPORT MENSUEL DE JUIN, (and so on, you need only 
type the first word.) 

Note that the French language does not have the possibility 
of translating these document names with the month name 
first. Even if the translator has understood the principle 
in English, it cannot be reproduced with this same example. 

If you know that an example cannot possibly be adapted for a 
particular language, you should try to find an alternative 
example in English, wherever possible. 
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• The ways in which a subfield of a date, identified by its 
POSITION, may be updated. 

American example: 

in the date '5/2A/82', the second field will change at 12 

P •F11 • 

L i tera ] trans ] at i on: 

(In the date) ‘24/5/82’ , (the second field will change at 
12 p.m.) 

For examples like this, you should simply highlight the 
problem for the translator, and ask him or her to deal with 
it. 

• The method of sorting a list of addresses, with the 

assumption that the house number will appear BEFORE the 
street name. 

Eng I i sh exampi e: 

To sort a list of addresses so that all the house numbers 
in the same street are in ascending order, select a NUMERIC 
FOLLOWED BY ALPHA sort. The result will look like this: 

1 High Street 
34 High St. 

76 High S t . 

3 Station Rd. 

Li teral translation: 

(To sort a list of addresses so that all the house numbers 
in the same street are In ascending order, select a NUMERIC 
FOLLOWED BY ALPHA sort.. The result will look like this:) 

Hochstr. 1 
Hochstr. 3^ 

Hochstr. 78 
Bahnhofstr. 3 

Note that even though the translator can see that “Hochstr. 
1“ is not numbers followed by letters, not enough information 
is available to supply the correct instructions to perform 
this task. 

You should therefore supply supplementary information so that 
the translator is in a position to adapt the example. 
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In general, try to avoid basing examples of field manipulation, 
searches, sorting, and so on, on any of the "language/country 
specific” categories listed in this section. 

If the example could lose its value when certain features of the 
wording or spelling are not reproduced in translation, make the text 
as simple and explicit as possible about the principle being 
illustrated. Insert an extra phrase such as “Consider this example of 
numeric characters followed by alphabetic characters". In addition, 
help the translator and the editor in the target country, by supplying 
them with a list of the sections of your text which are likely to 
require adaptation of this kind. Add details of the criteria you used 
in creating the original of these sections. Such notes would include: 

• The purpose of the example. 

• The restrictions that had been observed in the choice of the 
original example (for instance, “a file name not exceeding 6 
characters") . 

• Indication of any text that was required ONLY for users 
operating in English (for instance, if an English example was 
included to show that the words "through" and "thru" were 
interchangeable in a certain command). 


3 . 3*3 Use Of Tables, Diagrams And Figures 

When writing for translation, do not include humorous cartoons or 

pictures that indicate words directly. For example, a cartoon 

familiar to American readers might not translate into anything 
remotely similar in another language. 

• Label all parts of flowcharts and diagrams clearly and 

include a key to explain any symbols used. 

• Specifically avoid national symbols, such as mailboxes, 

flags, baseball, and so on. 

• Avoid putting text in boxes within diagrams. This causes 

problems if the translated text is much longer than the 

original . 


With regard to illustration, number all the parts which require 
explanation, and then supply a separate key in the text to explain the 
numbers. This keeps any text to be translated separate from the 
i 1 1 ustrat i on i tsel f . 
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A1 ternat i vel 
the 1 abel 1 
translated 1 


y, consider producing the diagram on 
i ng on a second transparency. I 
abel ling can be overlaid on the origi 


one transparency 
n this manner, 
nal diagram. 


and 

the 
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APPENDIX A 

DIACRITICAL CHARACTER ^^ATCHING 


This appendix lists those characters in the DIGITAL Multinational 
Character Set which have diacritical marks. Characters within the 
same group are treated as variants of the same character. Note that 
these rules apply when the language is unspecified. More complete 
rules are given in Section 2.3 

Letter Diacritical Character Group 


A 


C 

E 


I 


A 

Capi tal 

A 

wi th 

a 

Smal 1 

a 

wi th 

A 

Capi ta 1 

A 

wi th 

a 

Sma 1 1 

a 

w i th 

A 

Capi tal 

A 

wi th 

a 

Sma 1 1 

a 

wi th 

A 

Capi tal 

A 

wi th 


Smal 1 

a 

wi th 

w 

Capi tal 

A 

wi th 

V 

Sma 1 1 

a 

wi th 

9 

Cap i ta 1 

C 

wi th 

5 

Smal 1 

c 

w i th 

> 

E 

Capi tal 

E 

wi th 

6 

Sma 1 1 

e 

wi th 

/ 

E 

Capi tal 

E 

wi th 

f 

6 

Smal 1 

e 

wi th 

E 

Capi ta 1 

E 

wi th 

e 

Smal 1 

e 

wi th 

• • 

E 

Capi tal 

E 

wi th 

V 

Sma 1 1 

e 

wi th 

1 

Capi tal 

1 

wi th 

% 

1 

Smal 1 

i 

wi th 

r 

1 

Cap! tal 

1 

wi th 

f 

Smal 1 

i 

wi th 

A 

1 

Capi tal 

1 

wi th 


grave accent 
grave accent 
acute accent 
acute accent 
c i rcumf 1 ex 
c i rcumf 1 ex 
tilde 
tilde 

d i aeres i s/umlaut 
d i aeres i s/uml aut 

ced ilia 
ced ilia 

grave accent 
grave accent 
acute accent 
acute accent 
c i rcumf 1 ex 
c i rcumf 1 ex 
d i aeres i s/uml aut 
d i aeres i s/uml aut 

grave accent 
grave accent 
acute accent 
acute accent 
c i rcumf 1 ex 
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DIACRITICAL CHARACTER MATCHING 


A 

1 

Smal 1 

i with 

c i rcumf 1 ex 

V 

Cap! tal 

1 with 

d i aeres i s/umlaut 

• • 

1 

Smal 1 

i with 

d i aeres i s/umlaut 


0 

Capi tal 

0 

wi th 

grave accent 

0 

Sma] 1 

o 

wi th 

grave accent 

6 

Capi tai 

0 

wi th 

acute accent 

t 

o 

Sma ] 1 

o 

wi th 

acute accent 

6 

Capi tal 

0 

wi th 

c i rcumf 1 ex 

A 

0 

Sma 1 ] 

o 

wi th 

c i rcumf 1 ex 

0 

Capi tai 

0 

wi th 

tilde 

0 

Smal 1 

o 

wi th 

tilde 

0 

Capi tal 

0 

wi th 

d i aeres i s/umlaut 

0 

Smal 1 

o 

wi th 

d i aeres i s/umlaut 

\ 

U 

Cap i ta 1 

U 

wi th 

grave accent 

u 

Sma 1 1 

u 

wi th 

grave accent 

U 

Capi tal 

U 

wi th 

acute accent 

u 

Sma 1 1 

u 

wi th 

acute accent 

U 

Capi tal 

U 

wi th 

c i rcumf 1 ex 

u 

Smal 1 

u 

wi th 

c i rcumf 1 ex 

U* 

Capi tal 

U 

wi th 

d i aeres i s/uml aut 

u* 

Sma 1 1 

u 

wi th 

d i aeres i s/umlaut 

• • 

Y 

Capi tal 

Y 

wi th 

d i aeres i s/umlaut 

y 

Smal 1 

y 

wi th 

d i aeres i s/umlaut 
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DIGITAL MULTINATIONAL CHARACTER SET 


This table describes the graphic characters included in 
Multinational Character Set, The first 128 character pos 
0 to 177) exactly the same as the ASCII Character Set 

200 to 237 are addional control characters not described 


Octal 

Graphic character 

2k0 

reserved 


2i*l 

i 

inverted exclamation mark 

242 

€ 

cent sign 

243 

£ 

pound sign 

244 


reserved 

245 

X 

yen sign 

246 


reserved 

247 

s 

section sign 

250 

a 

general currency sign 

251 

© 

copyright sign 

252 

<3 

feminine ordinal indicator 

253 

« 

angle quotation mark left 

254 


reserved 

255 


reserved 

256 


reserved 

257 


reserved 

260 

0 

degree sign 

261 


plus/minus sign 

262 

2 

superscript 2 

263 

3 

superscript 3 

264 


reserved 

265 

M 

mi cro s i gn 

266 


paragraph sign 

267 

• 

middle dot 


the DIGITAL 
itions (octal 
. Positions 
here. 
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Octal 


270 

271 

272 

273 

21k 

275 

276 

277 

300 

301 

302 

303 
30L 

305 

306 

307 

310 

311 

312 
313 

31^* 

315 

316 

317 

320 

321 

322 

323 

321* 

325 

326 

327 

330 

331 

332 

333 
33^ 

335 

336 

337 


Graphic character 


reserved 
superscript 1 

2 masculine ordinal indicator 
» angle quotation mark right 

v« fraction one quarter 

V* fraction one half 

reserved 

i. inverted question mark 


A 

capi tal 

A 

wi th 

grave accent 

A 

capi tal 

A 

wi th 

acute accent 

A 

A 

capi tal 

A 

wi th 

c i rcumf 1 ex 

A 

capi tal 

A 

wi th 

tilde 

V 

capi tal 

A 

wi th 

d i aeres i s/umlaut 

A 

capi tal 

A 

wi th 

r i ng 


capi ta 1 

AE diphthong 

5 

capi tal 

C 

wi th 

ced ilia 

£ 

cap i ta 1 

E 

wi th 

grave accent 

£ 

capi tal 

E 

wi th 

acute accent 

£ 

capi tal 

E 

wi th 

c i rcumf 1 ex 

• • 

£ 

capi tal 

E 

wi th 

d i aeres i s/umlaut 

1^ 

capi tal 

1 

wi th 

grave accent 

r 

capi tal 

1 

wi th 

acute accent 

A 

1 

capi tal 

1 

wi th 

c i rcumf 1 ex 

• • 

1 

capital 1 
reserved 

wi th 

d i aeres i s/umlaut 

0m 

N 

capi tal 

N 

wi th 

tilde 

b 

capi tal 

0 

wi th 

grave accent 

0 

capi tal 

0 

wi th 

acute accent 

0 

capi tal 

0 

wi th 

c i rcumf 1 ex 

0 

capi tal 

0 

wi th 

tilde 

• # 

0 

capi tal 

0 

wi th 

d i aeres i s/umlaut 

OE 

capi tal 

OE ] i gature 

d 

cap i ta 1 

0 

wi th 

slash 

U 

capi tal 

u 

wi th 

grave accent 

u 

capi tal 

u 

wi th 

acute accent 

A 

u 

capi tal 

u 

wi th 

c i rcumf 1 ex 

• • 

u 

capi tal 

u 

wi th 

d i aeres i s/umlaut 

V 

capi tal 

Y 

wi th 

d i aeres i s/umlaut 


reserved 

jj German small sharp s 
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DIGITAL MULTINATIONAL CHARACTER SET 


Octal 

Graph 

iic character 


340 

a 

smal 1 

a wi th 

grave accent 

341 

r 

a 

smal ] 

a wi th 

acute accent 

342 

A 

a 

smal 1 

a wi th 

c i rcumf 1 ex 

343 

a 

sma] ] 

a wi th 

tilde 

344 

V 

smal 1 

a wi th 

d i aeres i s/uml aut 

345 

« 

a 

smal 1 

a wi th 

r i ng 

346 

ae 

smal 1 

ae diphthong 

347 

S 

sma 1 1 

c wi th 

ced ilia 

350 

e 

smal 1 

e wi th 

grave accent 

351 

e 

smal 1 

e wi th 

acute accent 

352 

e 

sma 1 1 

e wi th 

c i rcumf 1 ex 

353 

V 

smal 1 

e wi th 

d i aeres i s/uml aut 

354 

1 

sma 1 1 

i wi th 

grave accent 

355 

r 

smal 1 

i with 

acute accent 

356 

A 

1 

smal 1 

i with 

c i rcumf 1 ex 

357 

V 

sma 1 1 

i with 

d i aeres i s/uml aut 

360 


reserved 


361 

mm 

n 

smal 1 

n wi th 

tilde 

362 

\ 

0 

smal 1 

o wi th 

grave accent 

363 

r 

0 

smal 1 

0 wi th 

acute accent 

364 

A 

0 

sma 1 1 

o wi th 

c i rcumf 1 ex 

365 

mm 

0 

smal 1 

o wi th 

tilde 

366 

0 

smal 1 

o wi th 

d i aeres i s/uml aut 

367 

oi 

sma 1 1 

oe 1 i gature 

370 


smal 1 

o wi th 

s 1 ash 

371 

a 

smal 1 

u wi th 

grave accent 

372 

f 

u 

smal 1 

u wi th 

acute accent 

373 

A 

u 

smal 1 

u wi th 

c i rcumf 1 ex 

374 

u* 

sma 1 1 

u wi th 

d i aeres i s/uml aut 

375 

y 

smal 1 

/with 

di aeres i s/umlaut 

376 


reserved 


377 


reserved 
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